使用说明

项目简介

Deepseek Thinking Server 是一个基于 Model Context Protocol (MCP) 的服务器实现,它利用 Deepseek R1 推理模型为大型语言模型 (LLM) 客户端提供强大的思考和推理能力。通过注册 "thinking" 工具,该服务器允许 LLM 客户端在需要复杂推理或深入思考的场景中,调用 Deepseek 的能力来辅助生成更优质的回复。

主要功能点

  • 思考工具 (Thinking Tool): 核心功能,向 LLM 客户端提供一个名为 "thinking" 的工具。客户端可以发送对话上下文给这个工具,服务器会调用 Deepseek R1 模型进行推理,并将推理过程(chain of thought)返回给客户端。
  • MCP 服务器: 遵循 MCP 协议标准,能够与任何兼容 MCP 协议的客户端进行通信,例如 Claude Desktop。
  • 易于安装和配置: 提供简单的安装脚本和配置步骤,方便用户快速部署和使用。
  • 使用 Deepseek API: 集成了 Deepseek API,利用其强大的推理能力。

安装步骤

  1. 安装依赖: 打开终端,克隆仓库到本地,并进入仓库目录。

    git clone https://github.com/mattzcarey/mcp-thinking
    cd mcp-thinking
    bun install

    确保您已安装 Bun 作为 JavaScript 运行时。

  2. 配置 Deepseek API 密钥: 运行配置脚本,按照提示输入您的 Deepseek API 密钥。如果您还没有 Deepseek API 密钥,请先访问 Deepseek 平台 注册并创建。

    bun setup

    脚本会自动创建 MCP 配置文件,并将服务器配置信息添加到 Claude Desktop 的配置文件中。

服务器配置

对于 MCP 客户端(例如 Claude Desktop),您需要配置 MCP 服务器的连接信息。'bun setup' 脚本已经自动完成了 Claude Desktop 的配置。如果您需要手动配置或其他 MCP 客户端,请参考以下 JSON 配置信息:

{
  "mcpServers": {
    "thinking": { # 服务器名称,可以自定义,例如 "deepseek-thinking"
      "command": "bun", # 启动服务器的命令,这里使用 bun 运行时
      "args": [ "path/to/mcp-thinking/src/index.ts" ], # 启动命令的参数,指向服务器入口文件,请替换为您的实际路径
      "env": {
        "DEEPSEEK_API_KEY": "<YOUR_DEEPSEEK_API_KEY>" # 您的 Deepseek API 密钥,setup 脚本会自动写入,手动配置也需要替换为您自己的密钥
      }
    }
  }
}

请注意:

  • 'path/to/mcp-thinking/src/index.ts' 需要替换为 'src/index.ts' 文件的绝对路径。如果您不确定,可以保持相对路径 'src/index.ts',在大多数情况下 'bun' 能够正确解析。
  • '<YOUR_DEEPSEEK_API_KEY>' 是您的 Deepseek API 密钥,请确保在配置中正确设置。
  • 如果您使用的是 Claude Desktop 客户端,'bun setup' 脚本已经自动将上述配置写入 Claude Desktop 的配置文件 ('claude_desktop_config.json'),您无需手动修改。

基本使用方法

  1. 启动服务器: 当您运行 'bun setup' 脚本后,服务器配置已经添加到 Claude Desktop 的配置文件中。当 Claude Desktop 启动时,会自动检测并连接到配置的 MCP 服务器。

  2. 在 Claude Desktop 中使用 "thinking" 工具: 在 Claude Desktop 中与 LLM 对话时,如果客户端检测到需要进行复杂推理或思考的任务,它可能会自动或允许用户手动调用 "thinking" 工具。具体的调用方式取决于 Claude Desktop 客户端的实现。

    一般来说,当客户端需要使用 "thinking" 工具时,它会将当前的对话上下文(用户消息和之前的助手消息)发送给 "thinking" 工具。服务器接收到请求后,会调用 Deepseek R1 模型进行推理,并将推理结果返回给客户端。客户端可以根据推理结果生成最终的回复。

    请注意: 该服务器仅提供 "thinking" 工具,具体的工具调用和使用流程由 MCP 客户端(例如 Claude Desktop)控制。您需要在兼容的 MCP 客户端中使用才能体验到 "thinking" 工具的功能。

信息

分类

AI与计算