mcpserver.so LogoMCPFly
Submit
Thoughtful Claude logo

Thoughtful Claude

by martinbowling

AI/IntegrationreasoningDeepSeek R1Claude

Thoughtful Claude enhances Claude's reasoning by integrating DeepSeek R1's advanced reasoning engine. It provides Claude with access to a state-of-the-art reasoning model developed through large-scale reinforcement learning.

View on GitHub

Last updated: N/A

🤔 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

  1. Prerequisites

  2. 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

  1. Start the Server The server will automatically start when you use Claude Desktop with the proper configuration.

  2. 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

  3. 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

  1. Query Processing

    • Accepts context and question in structured format
    • Combines inputs for comprehensive reasoning

  2. DeepSeek R1 Integration

    • Model: deepseek-reasoner
    • Stream: Enabled for real-time processing
    • Max Tokens: 1 (optimized for reasoning extraction)
    • Output: Structured reasoning content

Error Handling

  • API Errors

    • Graceful error wrapping in <ant_thinking> tags
    • Clear error messages for debugging
    • Proper exception propagation

  • 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