FR3K structured thinking MCP server for coding implementation
npm install fr3k-thinkA structured thinking MCP server for coding implementation - guides coding agents through detailed thinking processes.
Version 1.0: Pure TypeScript Implementation
- 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
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:,
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 sessionDevelopment
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
``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
MIT License - See LICENSE file for details.
---
Built with frustration about Python dependencies and love for simple solutions.