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

$3

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

$3

Add to your configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

`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

`typescript
// 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

$3


`bash
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.