thoughtful-claude

🚀 深思Claude - DeepSeek R1推理服务器

深思Claude - DeepSeek R1推理服务器是一个增强Claude推理能力的MCP服务器，它通过整合DeepSeek R1先进的推理引擎，让Claude能够访问基于大规模强化学习开发的DeepSeek先进推理模型，有效解决复杂推理问题，提升推理效率和质量。

✨ 主要特性

• 高级推理集成：借助DeepSeek R1的推理引擎，与Claude的思考过程实现平滑结合，能够出色地处理复杂的多步骤推理任务。
• 企业级安全：支持使用环境变量（.env文件），安全处理API密钥，确保在响应中不暴露任何密钥信息。
• MCP协议支持：实现了全面的MCP服务器功能，可处理流式响应，并进行正确的错误管理。
• 现代Python架构：运用async/await进行高效处理，具备正确的异常处理机制和干净的代码组织。

📦 安装指南

先决条件

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

快速开始

# 克隆仓库
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界面中的🔨工具图标来验证安装是否成功。

🚀 快速开始

启动服务器

服务器在使用Claude Desktop正确配置时会自动启动。

基本工作流程

• Claude收到需要推理的查询。
• 查询发送到DeepSeek R1进行高级推理。
• 推理以<ant_thinking>标签包装返回给Claude。
• Claude将推理整合到其响应中。

示例查询

• 数学比较：“9.9是否大于9.11？”
• 逻辑谜题：“如果所有A都是B，且一些B是C，则我们可以得出什么结论？”
• 复杂分析：“比较和对比量子计算与经典计算”

🔧 技术细节

推理管道

1. 查询处理：接受上下文和问题的结构化格式，并结合输入以进行综合推理。
2. DeepSeek R1集成：
   • 模型：deepseek-reasoner
   • 流式：启用实时处理
   • 最大令牌数：1（优化用于推理提取）
   • 输出：结构化的推理内容

错误处理

• API错误：在<ant_thinking>标签中优雅地包装错误，提供清晰的错误消息用于调试，并进行正确的异常传播。
• 连接问题：设置超时处理（默认30秒），自动清理流，并进行资源管理。