FR3K-Think MCP 🚀

A structured thinking MCP server for coding implementation - guides coding agents through detailed thinking processes.

Version 1.0: Pure TypeScript Implementation

Features

• Structured Thinking Process - Guides through implementation thinking step by step
• Pure TypeScript - Built with the official @modelcontextprotocol/sdk
• Single Tool Design - One powerful think tool for all thinking needs
• Session Management - Track thinking progress and history
• Dynamic Guidance - Provides contextual thinking suggestions

Installation

One-Line Install (Claude Code)

claude mcp add fr3k-think -s user -- npx -y fr3k-think

Claude Desktop

Add to your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fr3k-think": {
      "command": "npx",
      "args": ["-y", "fr3k-think"]
    }
  }
}

Key Features

• Structured Thinking: Step-by-step guidance through coding implementation
• Session Tracking: Maintains thinking context across multiple thoughts
• Dynamic Guidance: Provides contextual suggestions based on thinking progress
• Investigation Support: Special handling for research and exploration phases
• Confidence Tracking: Monitor certainty levels throughout the process

Usage

The MCP provides a single think tool with these parameters:

• thought (required): Your current thinking content (should be rich and detailed)
• thoughtNumber (required): Current thought number (1, 2, 3...)
• totalThoughts (required): Total thoughts planned for this problem
• isInvestigating (optional): Set to true when researching/investigating
• investigationArea (optional): What you're investigating
• branchReason (optional): Reason for branching to alternative approach
• confidence (optional): Your confidence level (0.0-1.0)

Example Flow

// First thought - Understanding
think({
  thought: "Understanding dark mode toggle request. Need: UI component, theme state management, CSS architecture, persistence mechanism.",
  thoughtNumber: 1,
  totalThoughts: 3,
  isInvestigating: true,
  investigationArea: "existing UI patterns"
})

// Middle thought - Investigation results
think({
  thought: "Found: React Context for state, CSS variables for theming, localStorage for persistence. Will create ThemeContext with useTheme hook.",
  thoughtNumber: 2,
  totalThoughts: 3,
  confidence: 0.95
})

// Final thought - Implementation plan
think({
  thought: `Implementation plan:
    1. Create contexts/ThemeContext.jsx with ThemeProvider and useTheme hook
    2. Build components/ui/ThemeToggle.jsx using existing Button component  
    3. Add CSS variables to :root for --bg-color, --text-color
    4. Integrate: Wrap App in ThemeProvider, add toggle to Header
    5. Test: Verify persistence, smooth transitions, existing component compatibility`,
  thoughtNumber: 3,
  totalThoughts: 3
})

Resources

The MCP also provides resources for introspection:

• thinking://current - View current thinking session
• thinking://history - See all thoughts from current session

Development

To modify or extend FR3K-Think:

1. Clone the repository
2. Install dependencies: npm install
3. Make changes in src/index.ts
4. Build: npm run build
5. Test: npm start

Development with hot reload:

npm run dev

Philosophy

FR3K-Think provides structured thinking support for coding implementation:

1. Progressive Thinking - Build understanding step by step
2. Context Preservation - Maintain session state across thoughts
3. Dynamic Guidance - Contextual suggestions based on progress
4. Implementation Focus - Designed specifically for coding tasks
5. Minimal Interface - Simple parameters, powerful results

License

MIT License - See LICENSE file for details.

Built with frustration about Python dependencies and love for simple solutions.