🤔 Thoughtful Claude - DeepSeek R1 Reasoning Server

🤔 Thoughtful Claude - DeepSeek R1 推理服务

一个通过集成 DeepSeek R1 的先进推理引擎来增强 Claude 推理能力的 MCP 服务。该服务让 Claude 能够使用 DeepSeek 的先进推理模型，该模型通过大规模强化学习开发而成。

🌟 功能

• 先进推理集成

  • 利用 DeepSeek R1 的推理引擎
  • 与 Claude 的思考过程无缝集成
  • 处理复杂的多步推理任务

• 企业级安全

  • 支持环境变量（.env 文件）
  • 安全地处理 API 密钥
  • 不会在响应中泄露密钥

• MCP 协议支持

  • 完整实现 MCP 服务
  • 处理流式响应
  • 妥善管理错误

• 现代 Python 架构

  • 使用 async/await 高效处理
  • 妥善处理异常
  • 代码组织清晰

📦 安装

1. 先决条件

   • Python 3.12+
   • uv 包管理器
   • DeepSeek API 密钥（可从 platform.deepseek.com 获取）

2. 快速开始

# 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

mcp install 命令将：

• 在 Claude Desktop 中注册此服务
• 使用 .env 中的环境变量进行设置
• 配置服务，使其使用正确的 Python 解释器运行

你可以在 Claude Desktop 界面中查找 🔨 工具图标，以确认安装成功。

🚀 使用方法

1. 启动服务 配置正确后，当你使用 Claude Desktop 时，服务会自动启动。

2. 基本工作流

   • Claude 收到需要推理的查询
   • 查询被发送到 DeepSeek R1 进行高级推理
   • 推理结果会封装在 <ant_thinking> 标签中并返回给 Claude
   • Claude 将推理结果融入回复

3. 示例查询

   • 数学比较：“9.9 是否大于 9.11？”
   • 逻辑谜题：“如果所有 A 都是 B，且某些 B 是 C，我们能得出什么结论？”
   • 复杂分析：“比较量子计算与经典计算，并说明两者的异同”

🧠 技术细节

推理流程

1. 查询处理

   • 以结构化格式接收上下文和问题
   • 合并输入，以便进行全面推理

2. DeepSeek R1 集成

   • 模型：deepseek-reasoner
   • 流式处理：启用，以便实时处理
   • 最大令牌数：1（针对推理提取进行了优化）
   • 输出：结构化推理内容

错误处理

• API 错误

  • 在 <ant_thinking> 标签中妥善封装错误
  • 提供清晰的错误消息以便调试
  • 妥善传播异常

• 连接问题

  • 超时处理（默认 30 秒）
  • 自动清理数据流
  • 资源管理

🛠 故障排除

常见问题

# Server not found in Claude Desktop
ERROR: MCP server not detected

# Solution
Check claude_desktop_config.json path and format

性能提示

• 保持查询聚焦且具体
• 在可用时提供相关上下文
• 对复杂查询使用结构化输入格式

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE

🙏 致谢

• DeepSeek R1 - 感谢其在推理能力方面的突破性工作
• Claude - 感谢其先进的 AI 助手平台
• MCP Protocol - 感谢其实现了 AI 工具的无缝集成