About Thoughtful Claude
Thoughtful Claude is an MCP server published by martinbowling in the Developer Tools category: mCP server that enhances Claude's reasoning capabilities by integrating DeepSeek R1's advanced reasoning engine 🤔.
The repository has 55 stars and 8 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/martinbowling/thoughtful-claudeThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Thoughtful Claude
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
🤔 Thoughtful Claude - DeepSeek R1 Reasoning Server
An MCP server that enhances Claude's reasoning capabilities by integrating DeepSeek R1's advanced reasoning engine. This server provides Claude with access to DeepSeek's state-of-the-art reasoning model, developed through large-scale reinforcement learning.
🌟 Features
-
Advanced Reasoning Integration
- Leverages DeepSeek R1's reasoning engine
- Seamlessly integrates with Claude's thought process
- Handles complex multi-step reasoning tasks
-
Enterprise-Grade Security
- Environment variable support (.env file)
- Secure API key handling
- No key exposure in responses
-
MCP Protocol Support
- Full MCP server implementation
- Streaming response handling
- Proper error management
-
Modern Python Architecture
- Async/await for efficient processing
- Proper exception handling
- Clean code organization
📦 Installation
-
Prerequisites
- Python 3.12+
- uv package manager
- DeepSeek API key (get one from platform.deepseek.com)
-
Quick Start
# Clone repository
git clone https://github.com/martinbowling/thoughtful-claude.git
cd thoughtful-claude
# Install MCP and dependencies
pip install "mcp[cli]" httpx python-dotenv
# Create .env file with your API key
echo "DEEPSEEK_API_KEY=your_key_here" > .env
# Install the MCP server with environment variables
mcp install server.py -f .env
The mcp install command will:
- Register the server with Claude Desktop
- Set up the environment variables from
.env - Configure the server to run with the correct Python interpreter
You can verify the installation by checking for the 🔨 Tools icon in Claude Desktop's interface.
🚀 Usage
-
Start the Server The server will automatically start when you use Claude Desktop with the proper configuration.
-
Basic Workflow
- Claude receives a query requiring reasoning
- Query is sent to DeepSeek R1 for advanced reasoning
- Reasoning is returned to Claude wrapped in
<ant_thinking>tags - Claude incorporates the reasoning into its response
-
Example Queries
- Mathematical comparisons: "Is 9.9 greater than 9.11?"
- Logic puzzles: "If all A are B, and some B are C, what can we conclude?"
- Complex analysis: "Compare and contrast quantum computing with classical computing"
🧠 Technical Details
Reasoning Pipeline
-
Query Processing
- Accepts context and question in structured format
- Combines inputs for comprehensive reasoning
-
DeepSeek R1 Integration
- Model:
deepseek-reasoner - Stream: Enabled for real-time processing
- Max Tokens: 1 (optimized for reasoning extraction)
- Output: Structured reasoning content
- Model:
Error Handling
-
API Errors
- Graceful error wrapping in
<ant_thinking>tags - Clear error messages for debugging
- Proper exception propagation
- Graceful error wrapping in
-
Connection Issues
- Timeout handling (30s default)
- Automatic stream cleanup
- Resource management
🛠 Troubleshooting
Common Issues
# Server not found in Claude Desktop
ERROR: MCP server not detected
# Solution
Check claude_desktop_config.json path and format
Performance Tips
- Keep queries focused and specific
- Provide relevant context when available
- Use structured input format for complex queries
📄 License
MIT License - See LICENSE for details
🙏 Acknowledgments
- DeepSeek R1 - For their groundbreaking work in reasoning capabilities
- Claude - For the advanced AI assistant platform
- MCP Protocol - For enabling seamless AI tool integration
README fetched from the repository 5 days ago. The original is authoritative.