mcpField
🤔
🤔 Thoughtful Claude - DeepSeek R1 Reasoning Server

🤔 Thoughtful Claude - DeepSeek R1 Reasoning Server

Local
github.com/martinbowlingAI & Agents55Updated 92w ago
Repository

About 🤔 Thoughtful Claude - DeepSeek R1 Reasoning Server

An MCP server that adds DeepSeek R1's reasoning model to Claude for multi-step reasoning. It suits users who need help with math comparisons, logic puzzles or complex analysis. API keys are read from a .env file.

Key features

  1. 01DeepSeek R1 reasoning model integration
  2. 02Multi-step reasoning for complex queries
  3. 03API key loading from .env file
  4. 04Async Python implementation

Use cases

  1. 01Math comparisons such as decimal ordering
  2. 02Logic puzzle analysis
  3. 03Comparative analysis of complex topics

MCP support

The server runs as an MCP server that Claude Desktop can register. It exposes reasoning to the client, which forwards requests to DeepSeek R1 and returns the results.

#mathgpt#math-solver#math-assistant

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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

  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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.