🤔 Thoughtful Claude - DeepSeek R1 推理服务器

一个 MCP 服务器，通过集成 DeepSeek R1 的高级推理引擎来增强 Claude 的推理能力。该服务器为 Claude 提供对 DeepSeek 最先进的推理模型的访问，该模型是通过大规模强化学习开发的。

🌟 特性

• 高级推理集成

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

• 企业级安全

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

• MCP 协议支持

  • 完整的 MCP 服务器实现
  • 流式响应处理
  • 正确的错误管理

• 现代 Python 架构

  • Async/await 用于高效处理
  • 正确的异常处理
  • 清晰的代码组织

📦 安装

1. 前提条件

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

2. 快速开始

# 克隆仓库
git clone https://github.com/martinbowling/thoughtful-claude.git
cd thoughtful-claude

# 安装 MCP 和依赖项
pip install "mcp[cli]" httpx python-dotenv

# 创建包含 API 密钥的 .env 文件
echo "DEEPSEEK_API_KEY=your_key_here" > .env

# 使用环境变量安装 MCP 服务器
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
   • 流：启用以进行实时处理
   • 最大 Token 数：1（针对推理提取进行了优化）
   • 输出：结构化的推理内容

错误处理

• API 错误

  • 在 <ant_thinking> 标签中进行优雅的错误包装
  • 清晰的错误消息，便于调试
  • 正确的异常传播

• 连接问题

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

🛠 故障排除

常见问题

# 在 Claude Desktop 中找不到服务器
ERROR: MCP server not detected

# 解决方案
检查 claude_desktop_config.json 路径和格式

性能提示

• 保持查询的重点和具体性
• 在可用时提供相关上下文
• 使用结构化输入格式处理复杂查询

📄 许可证

MIT 许可证 - 有关详细信息，请参阅 LICENSE

🙏 致谢

• DeepSeek R1 - 感谢他们在推理能力方面的开创性工作
• Claude - 感谢先进的 AI 助手平台
• MCP 协议 - 感谢它实现了无缝的 AI 工具集成