DeepSeek MCP Server 使用说明

项目简介

DeepSeek MCP Server 是一个桥梁，它将 DeepSeek 强大的语言模型 API 与 Model Context Protocol (MCP) 连接起来。通过这个服务器，你可以让任何兼容 MCP 协议的客户端（例如 Claude Desktop）轻松访问和使用 DeepSeek 的语言模型，就像使用本地服务一样方便。

主要功能点

DeepSeek API 代理: 将 DeepSeek API 转化为标准的 MCP 接口，方便 MCP 客户端集成。
模型选择: 支持 DeepSeek 提供的 'deepseek-chat' 和 'deepseek-reasoner' 两种模型，并允许用户根据需求选择。
参数配置: 允许用户通过 MCP 客户端配置模型参数，例如温度 (temperature)、最大 tokens (max_tokens)、Top P、频率惩罚 (frequency_penalty) 和存在惩罚 (presence_penalty) 等。
多轮对话支持: 服务器维护完整的对话历史记录，支持连续的多轮对话，并保持上下文信息。
自动模型回退: 当默认模型 'deepseek-reasoner' 不可用时，服务器会自动尝试使用 'deepseek-chat' 模型，保证服务的可用性。
资源发现: 提供 'models' 和 'model-config' 资源，允许客户端查询可用的模型列表和配置选项。

安装步骤

方法一：通过 Smithery 自动安装 (推荐 Claude Desktop 用户)

如果你使用 Claude Desktop，可以通过 Smithery 快速安装：

npx -y @smithery/cli install @dmontgomery40/deepseek-mcp-server --client claude

方法二：手动安装

如果你不使用 Claude Desktop 或希望手动安装，可以使用 npm 全局安装：

npm install -g deepseek-mcp-server

服务器配置

要让 MCP 客户端（例如 Claude Desktop）连接到 DeepSeek MCP Server，你需要在客户端的配置文件中添加服务器信息。以 'claude_desktop_config.json' 为例，你需要添加如下配置：

{
  "mcpServers": {
    "deepseek": {  // 服务器名称，可以自定义
      "command": "npx",  // 启动服务器的命令，这里使用 npx 执行 npm 包
      "args": [  // 命令参数
        "-y",
        "deepseek-mcp-server" //  执行 deepseek-mcp-server npm 包
      ],
      "env": {  // 环境变量
        "DEEPSEEK_API_KEY": "YOUR_DEEPSEEK_API_KEY"  //  你的 DeepSeek API 密钥，请替换为实际密钥
      }
    }
  }
}

请务必将 'YOUR_DEEPSEEK_API_KEY' 替换为你真实的 DeepSeek API 密钥。

基本使用方法

启动服务器: 安装完成后，DeepSeek MCP Server 会在后台运行 (通过 Smithery 安装) 或当你手动执行 'deepseek-mcp-server' 命令时启动 (手动安装)。
配置 MCP 客户端: 根据你的 MCP 客户端（例如 Claude Desktop）的文档，配置 MCP 服务器连接信息，通常是提供上面 '服务器配置' 中生成的 JSON 内容。
使用 MCP 客户端与 DeepSeek 模型对话: 配置完成后，你就可以在 MCP 客户端中使用 DeepSeek 模型进行对话了。客户端会通过 MCP 协议与 DeepSeek MCP Server 通信，服务器会将请求转发到 DeepSeek API 并返回结果。

测试服务器 (可选)

你可以使用 MCP Inspector 工具测试本地运行的 DeepSeek MCP Server：

构建服务器: 如果你是从源码安装，需要先构建：
```
npm run build
```
运行 MCP Inspector:
```
npx @modelcontextprotocol/inspector node ./build/index.js
```
MCP Inspector 会在浏览器中打开，并连接到通过 stdio 传输的服务器。你可以在 Inspector 中查看可用的工具、测试聊天补全等功能。

关键词