📌Overview

Purpose: Enhance Claude's reasoning capabilities by integrating DeepSeek R1's advanced reasoning engine.

Overview: The DeepSeek R1 Reasoning Server is designed to augment Claude's reasoning abilities, leveraging a sophisticated reasoning model developed through extensive reinforcement learning. This server facilitates seamless multi-step reasoning tasks while prioritizing security and performance.

Key Features:

• Advanced Reasoning Integration:

  • Utilizes DeepSeek R1's reasoning engine, enabling Claude to tackle complex reasoning tasks effectively.

• Enterprise-Grade Security:

  • Implements secure API key handling and environment variable support, ensuring no key exposure in responses.

• MCP Protocol Support:

  • Provides full MCP server implementation with streaming response capabilities and robust error management.

• Modern Python Architecture:

  • Employs async/await for efficiency, featuring clean code organization and effective exception handling.

---

🤔 Thoughtful Claude - DeepSeek R1 Reasoning Server

An MCP server that enhances Claude's reasoning capabilities by integrating DeepSeek R1's advanced reasoning engine.

🌟 Features

• Advanced Reasoning Integration

  • Leverages DeepSeek R1's reasoning engine
  • Handles complex multi-step reasoning tasks

• Enterprise-Grade Security

  • Environment variable support
  • Secure API key handling

• MCP Protocol Support

  • Full MCP server implementation
  • Streaming response handling

• Modern Python Architecture

  • Async/await for efficient processing
  • Proper exception handling

📦 Installation

1. Prerequisites

   • Python 3.12+
   • uv package manager
   • DeepSeek API key

2. Quick Start

   git clone https://github.com/martinbowling/thoughtful-claude.git
   cd thoughtful-claude
   pip install "mcp[cli]" httpx python-dotenv
   echo "DEEPSEEK_API_KEY=your_key_here" > .env
   mcp install server.py -f .env
   

🚀 Usage

1. Start the Server The server starts automatically when configured with Claude Desktop.

2. Basic Workflow

   • Claude receives a query requiring reasoning.
   • Query is sent to DeepSeek R1 for advanced reasoning.
   • Reasoning is returned to Claude.

3. Example Queries

   • "Is 9.9 greater than 9.11?"
   • "If all A are B, and some B are C, what can we conclude?"
   • "Compare and contrast quantum computing with classical computing."

🧠 Technical Details

Reasoning Pipeline

1. Query Processing

   • Accepts context and question in a structured format.

2. DeepSeek R1 Integration

   • Model: deepseek-reasoner
   • Stream: Enabled for real-time processing

Error Handling

• API Errors

  • Graceful error wrapping and clear messages.

• Connection Issues

  • Timeout handling and resource management.

🛠 Troubleshooting

Common Issues

# Server not detected
ERROR: MCP server not detected

# Solution
Check the configuration file path and format.

Performance Tips

• Keep queries focused and specific.
• Provide relevant context when possible.

📄 License

MIT License - See LICENSE for details.

🙏 Acknowledgments

• DeepSeek R1 - For their advancements in reasoning capabilities.
• Claude - For the advanced AI assistant platform.
• MCP Protocol - For enabling seamless AI tool integration.