使用说明

项目简介

Thoughtful Claude DeepSeek Reasoner 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在增强 Claude 等大型语言模型的推理能力。它通过集成 DeepSeek R1 的先进推理引擎，为 Claude 提供了一个强大的外部推理工具。该服务器允许 Claude 将复杂的推理任务委托给 DeepSeek R1 处理，从而提升 Claude 在逻辑分析、数学计算和知识推理等方面的表现。

主要功能点

DeepSeek R1 推理引擎集成: 利用 DeepSeek R1 强大的推理能力，处理复杂查询，提升 Claude 的推理质量。
'reason' 工具: 提供名为 'reason' 的工具，允许 Claude 通过简单的指令调用 DeepSeek R1 进行推理，并将推理结果以特定格式返回 Claude。
MCP 协议支持: 完全实现了 MCP 服务器协议，可以无缝对接任何兼容 MCP 协议的客户端，例如 Claude 桌面应用。
安全配置: 通过读取 '.env' 文件中的环境变量来管理 DeepSeek API 密钥，保证密钥的安全性，避免泄露。
易于安装和使用: 提供了简洁的安装步骤和配置方法，方便用户快速部署和使用。

安装步骤

前提条件: 确保你的系统已安装 Python 3.12 或更高版本，并安装了 'uv' 包管理器（通常 'pip' 也可以）。你需要拥有 DeepSeek API 密钥 (从 platform.deepseek.com 获取)。
克隆仓库: 打开终端，执行命令 'git clone https://github.com/martinbowling/thoughtful-claude.git' 克隆仓库到本地。
进入项目目录: 执行 'cd thoughtful-claude' 进入项目目录。
安装依赖: 执行 'pip install "mcp[cli]" httpx python-dotenv' 安装项目所需的 Python 依赖库。
创建 '.env' 文件: 在项目根目录下创建名为 '.env' 的文件，并将你的 DeepSeek API 密钥写入该文件，例如 'echo "DEEPSEEK_API_KEY=your_api_key_here" > .env' (请将 'your_api_key_here' 替换为你的实际密钥)。
安装 MCP 服务器: 执行 'mcp install server.py -f .env' 命令来安装和注册 MCP 服务器。此命令会将服务器注册到 Claude Desktop，并配置环境变量。

服务器配置 (JSON 格式)

以下 JSON 配置信息用于配置 MCP 客户端（如 Claude Desktop）以连接到此 MCP 服务器。

{
  "server_name": "Thoughtful Claude DeepSeek Reasoner",
  "command": "mcp",
  "args": ["run", "server.py"]
}

'server_name': 服务器的名称，在 MCP 客户端中显示为服务器标识。
'command': 启动服务器的命令，这里使用 'mcp' 命令行工具。
'args': 传递给 'mcp run' 命令的参数，指定要运行的服务器文件为 'server.py'。

注意: 用户通常无需手动配置 JSON，'mcp install' 命令会自动完成服务器的安装和注册。上述 JSON 配置信息仅供参考，帮助用户理解 MCP 客户端如何配置连接此服务器。

基本使用方法

启动服务器: 当你在 Claude Desktop 中启用已安装的 "Thoughtful Claude DeepSeek Reasoner" 工具后，服务器会在后台自动启动。
在 Claude 中提问: 在 Claude 对话中，你可以提出需要推理的问题。当 Claude 判断需要使用外部推理能力时，会自动调用 'reason' 工具。例如，你可以提问：
- "9.9 比 9.11 大吗？"
- "如果所有鸟都会飞，企鹅是鸟，那么企鹅会飞吗？"
- "量子计算机和经典计算机有什么区别？"
查看推理结果: 服务器会将 DeepSeek R1 的推理结果包装在 '<ant_thinking>' 标签中返回给 Claude。Claude 会基于这些推理过程给出最终答案。

关键词

推理增强, 外部推理工具, DeepSeek R1, Claude 插件, 逻辑推理