What is Thoughtful Claude

Thoughtful-Claude is an MCP server designed to enhance Claude’s reasoning capabilities by integrating DeepSeek R1’s advanced reasoning engine, providing access to a state-of-the-art reasoning model developed through large-scale reinforcement learning.

Use cases

Use cases for Thoughtful-Claude include mathematical comparisons, logic puzzles, and complex analyses, allowing users to leverage advanced reasoning for a variety of queries.

How to use

To use Thoughtful-Claude, clone the repository, install the necessary dependencies, create a .env file with your DeepSeek API key, and start the server using Claude Desktop. The server will automatically handle reasoning queries sent by Claude.

Key features

Key features include advanced reasoning integration with DeepSeek R1, enterprise-grade security with secure API key handling, full MCP protocol support, and a modern Python architecture utilizing async/await for efficient processing.

Where to use

undefined

🤔 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

   • Python 3.12+
   • uv package manager
   • DeepSeek API key (get one from platform.deepseek.com)

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