← 返回目录
D

DeepSeek MCP Server

社区
接入 DeepSeek V4 的社区 MCP 服务器,支持对话、推理、函数调用与成本追踪。
GitHub 源仓库 ↗
★ 17 Stars 分类 · 开发工具 热门
63FMRS · C

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

可靠性
9/20
安全与权限
13/20
维护活跃度
11/20
文档质量
17/20
安装易用性
13/20
查看 FMRS 评分方法 →

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 官方产品。

工具能力

deepseek_chat
与 DeepSeek 模型对话,支持函数调用、思维链推理模式、JSON 输出、Schema 校验、多轮会话及自动成本追踪。
deepseek_fim
中间补全(Fill-in-the-Middle):给定前缀与可选后缀,模型补全中间内容,适用于代码补全与内容填充。
deepseek_sessions
管理会话:列出、删除或清空多轮对话会话。

安装接入

需要 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"。

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

选型与风险

适合谁

  • 使用 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 将在下一个大版本移除

常见排障

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

使用场景

使用 deepseek-v4-pro 进行复杂推理与数学证明
启用思维链模式的逐步调试与代码审查
带 Schema 校验的结构化 JSON 输出
通过 FIM 进行代码中间补全
带成本追踪的多轮对话会话

支持客户端

Claude Code完整支持
Gemini CLI完整支持
Cursor完整支持
Windsurf完整支持
VS Code完整支持