DeepSeek MCP Server

社区

接入 DeepSeek V4 的社区 MCP 服务器，支持对话、推理、函数调用与成本追踪。

分类: 开发工具第 74 / 438
Stars: ★ 26 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 20+ · Docker · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 47 天前
工具数: 3

63FMRS · C

一个功能完善、文档详尽的社区 DeepSeek MCP 服务器，提供 V4 双模型、会话管理、Schema 校验 JSON、成本追踪和熔断回退等企业级特性，测试覆盖约 89%。适合想在 MCP 工作流中集成 DeepSeek 的开发者，但需注意它是非官方项目，且自托管 HTTP 模式需妥善保护端点。

最强项 · 文档质量 17/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

13/20

维护活跃度

11/20

文档质量

17/20

安装易用性

13/20

查看各项评分依据

可靠性 9/20: README 内部对工具集(deepseek_chat/deepseek_fim/deepseek_sessions)、资源(deepseek://models/config/usage)与项目目录结构描述一致，且说明了熔断器、模型回退、重试、schema 修复重试等错误处理机制，设计思路完整。但本次审查为纯静态阅读，未获得实际的 CI workflow 文件内容或测试源码，'280 tests, ~89% coverage' 与 CI 徽章仅为文档中的自述，无法核实其真实性，也无法验证 MCP 初始化/工具列表握手在真实环境下可复现。按规则可验证执行证据缺失时可靠性不得超过12分，故评为9分。
安全与权限 13/20: 密钥处理较规范：DEEPSEEK_API_KEY 标记为必需且为 secret，HTTP 自托管模式默认绑定 127.0.0.1，暴露到 0.0.0.0 时文档要求设置 HTTP_AUTH_TOKEN 与 HTTP_ALLOWED_HOSTS 防止 DNS rebinding，Docker 示例也默认只发布到本机回环地址，体现了最小暴露面的设计。未发现破坏性操作、无需确认的远程命令执行或仓库中硬编码的真实密钥。扣分项：manifest 中提供的托管远程端点(deepseek-mcp.tahirl.com)要求用户将 DeepSeek API Key 作为 Bearer token 发送给第三方运营的 Cloudflare Worker，README 声称'不在服务器端存储密钥'，但这只是维护者单方面声明，静态材料中无法验证该第三方服务的数据流、日志留存或密钥转发行为，存在无法核实的数据边界风险；此外会话隔离、schema ReDoS 防护等安全声明同样无法从源码层面验证。未达到红线级别，但风险与信任依赖较为突出，故未给高分。
维护活跃度 11/20: 仓库为 MIT 许可，未被归档，manifest 版本号2.3.0 且 README 提供 CHANGELOG.md 与 CONTRIBUTING.md 引用，显示存在版本管理与协作流程雏形。但仅17颗星却有10个未关闭issue，issue密度偏高，且缺乏可验证的近期提交记录、发布节奏或安全响应渠道说明，维护者为单人(@arikusi)，治理结构单薄。缺乏可核实的持续维护证据，只能给中等偏下分数。
文档质量 17/20: 文档质量整体较高：安装(本地/远程/Docker)、鉴权方式、每个工具的参数与返回结构、限制(如FIM输出上限4096 tokens、消息长度上限)、成本定价表、故障排查章节、多环境配置示例一应俱全，并对已弃用别名、会话隔离范围、ReDoS防护等边界情况做了说明，体现了较强的透明度。扣分点在于：部分安全性声明(如'远程端点不存储密钥'、'89% 覆盖率')属自述而非可验证证据，文档虽提及但未提供独立可复核的来源。
安装易用性 13/20: 提供了本地 stdio(npx)、远程无安装 BYOK、手动配置、Docker 等多种清晰的安装路径，并给出 Claude Code、Gemini CLI、Cursor/Windsurf/VS Code 等主流客户端的具体命令示例，步骤直观、依赖(Node 20+)说明清楚。但按静态审查规则，在缺少可验证的 CI 与测试证据证明这些安装路径被自动化验证过的情况下，安装易用性得分不得超过15分，故结合文档清晰度给出13分。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

使用 Claude Code、Gemini CLI、Cursor、Windsurf 等 MCP 客户端的开发者
需要在本地代理中调用 DeepSeek V4 模型的用户
关注成本追踪与用量统计的团队
需要 BYOK 托管端点、免安装使用的用户

不适合谁

寻求 DeepSeek 官方支持渠道的用户（这是社区维护项目）
无法提供 DeepSeek API 密钥的用户
需要 OpenAI、Anthropic 等其他 LLM 提供商的用户

所需权限

必需 DEEPSEEK_API_KEY 环境变量（密钥）
通过 DeepSeek API 密钥产生 API 调用费用
自托管 HTTP 模式下需开放网络端口（默认仅绑定 127.0.0.1）

风险与副作用

HTTP 端点暴露时，任何能访问 POST /mcp 的人都可消耗你的 API 密钥；绑定 0.0.0.0 时必须设置 HTTP_AUTH_TOKEN
思维链模式可能超过 30 秒，部分客户端的工具调用超时可能中断长请求
API 密钥费用由实际使用产生，成本随调用量增长
已弃用的模型别名 deepseek-chat/deepseek-reasoner 将在下一个大版本移除

安装接入

准备工作

运行环境：Node.js 20+ · Docker · 远程托管（无需本地环境）

DEEPSEEK_API_KEY 必填密钥 DeepSeek 平台的 API 密钥，必需，在 https://platform.deepseek.com 获取。

HTTP_AUTH_TOKEN 可选密钥自托管 HTTP 端点的静态网关令牌，设置后 POST /mcp 需要 Bearer 认证。

其他可选配置项（19 个）

DEEPSEEK_BASE_URL 可选自定义 DeepSeek API 端点，默认 https://api.deepseek.com。

DEFAULT_MODEL 可选默认使用的模型，默认 deepseek-v4-flash。

SHOW_COST_INFO 可选是否在响应中显示成本信息，默认 true。

REQUEST_TIMEOUT 可选请求超时时间（毫秒），默认 60000。

MAX_RETRIES 可选失败请求的最大重试次数，默认 2。

SKIP_CONNECTION_TEST 可选是否跳过启动时的 API 连接测试，默认 false。

MAX_MESSAGE_LENGTH 可选单条消息内容的最大字符数，默认 100000。

SESSION_TTL_MINUTES 可选会话存活时间（分钟），默认 30。

MAX_SESSIONS 可选最大并发会话数，默认 100。

FALLBACK_ENABLED 可选是否启用模型自动回退，默认 true。

CIRCUIT_BREAKER_THRESHOLD 可选熔断器打开前的连续失败次数，默认 5。

CIRCUIT_BREAKER_RESET_TIMEOUT 可选熔断器进入半开状态前的等待毫秒数，默认 30000。

MAX_SESSION_MESSAGES 可选每个会话最多保存的消息数（滑动窗口），默认 200。

RESPONSE_SCHEMA_MAX_RETRIES 可选 response_schema 校验失败时的修复重试次数，默认 2，设 0 禁用。

ENABLE_MULTIMODAL 可选是否启用多模态（图片）输入，默认 false。

TRANSPORT 可选传输模式：stdio 或 http，默认 stdio。

HTTP_PORT 可选 HTTP 传输模式下的服务端口，默认 3000。

HTTP_HOST 可选 HTTP 服务绑定地址，默认 127.0.0.1。

HTTP_ALLOWED_HOSTS 可选逗号分隔的允许 Host 头列表，用于绑定 0.0.0.0 时的 DNS 重绑定防护。

需要 Node.js 20+ 和 DeepSeek API 密钥（platform.deepseek.com 获取）。Claude Code 本地安装：claude mcp add -s user deepseek npx @arikusi/deepseek-mcp-server -e DEEPSEEK_API_KEY=your-key-here。Gemini CLI：gemini mcp add deepseek npx @arikusi/deepseek-mcp-server -e DEEPSEEK_API_KEY=your-key-here。也可使用托管端点（无需安装）：claude mcp add --transport http deepseek https://deepseek-mcp.tahirl.com/mcp --header "Authorization: Bearer YOUR_DEEPSEEK_API_KEY"。

.mcp.json

{"mcpServers":{"deepseek":{"command":"npx","args":["@arikusi/deepseek-mcp-server"],"env":{"DEEPSEEK_API_KEY":"your-api-key-here"}}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "deepseek": {
      "command": "npx",
      "args": [
        "@arikusi/deepseek-mcp-server"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "your-api-key-here"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add deepseek -e DEEPSEEK_API_KEY=your-api-key-here -- npx @arikusi/deepseek-mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后在客户端工具列表中应出现 deepseek_chat、deepseek_fim 和 deepseek_sessions 三个工具；让客户端用 DeepSeek 回答一个问题，收到带 token 和成本信息的回复即说明连接成功。

常见排障

提示 DEEPSEEK_API_KEY 未设置：确认 add 命令包含 -e 标志或在配置文件的 env 中添加密钥
连接 DeepSeek API 失败：检查密钥有效性、网络连接及 status.deepseek.com 服务状态
MCP 客户端中看不到服务器：确认 dist/index.js 路径正确、已执行 npm run build，并完全重启客户端
macOS/Linux 权限被拒：执行 chmod +x dist/index.js

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 DeepSeek 解释一下量子计算
使用 deepseek-v4-pro 并开启 thinking 模式，证明 2 的平方根是无理数
用 deepseek_fim 补全这段 Python 代码的前后文中间缺失部分
列出当前所有会话，然后删除 session_id 为 my-session-1 的会话

工具能力 3

deepseek_chat 只读

与 DeepSeek 模型对话，支持函数调用、思维链推理模式、JSON 输出、Schema 校验、多轮会话及自动成本追踪。

deepseek_fim 只读

中间补全（Fill-in-the-Middle）：给定前缀与可选后缀，模型补全中间内容，适用于代码补全与内容填充。

deepseek_sessions 写入

管理会话：列出、删除或清空多轮对话会话。

使用场景

使用 deepseek-v4-pro 进行复杂推理与数学证明

启用思维链模式的逐步调试与代码审查

带 Schema 校验的结构化 JSON 输出

通过 FIM 进行代码中间补全

带成本追踪的多轮对话会话

支持客户端

Claude Code

Gemini CLI

Cursor

Windsurf

VS Code

依据项目文档列出，未经本站实测。

详细介绍

DeepSeek MCP Server 是一个由社区维护的开源（MIT）MCP 服务器，用于访问 DeepSeek V4 模型（deepseek-v4-flash 与 deepseek-v4-pro），两者均具备 1M token 上下文窗口和可选的思维链推理模式。它提供多轮会话、函数调用（最多 128 个工具定义）、JSON 输出与 Schema 校验、中间补全（FIM）、具备缓存命中统计的成本追踪、模型故障自动回退与熔断保护、12 个提示词模板，以及 3 个 MCP 资源（模型、配置、用量）。可通过 npm（stdio）或托管 BYOK 端点（Streamable HTTP）运行，兼容 Claude Code、Gemini CLI、Cursor、Windsurf 等 MCP 客户端。注意：这是独立社区项目，并非 DeepSeek 官方产品。