DeepSeek MCP Server

社区

为 DeepSeek V4.1 Flash 提供聊天、Responses、FIM 与 Files API 的 MCP 服务器

★ 352 Stars 分类 · 开发工具非常热门

64FMRS · C

这是一个社区维护的 DeepSeek MCP 服务器，覆盖 V4.1 Flash 的聊天、Responses、FIM、Files、模型与余额等接口，工具定义清晰并带有输出 schema 与行为注解。它适合需要在 MCP 客户端中调用 DeepSeek 的开发者，但需要注意 API 密钥与托管令牌的保管、上传文件的存储与过期策略，以及托管端点可能滞后于最新版本的问题。

可靠性

10/20

安全与权限

13/20

维护活跃度

12/20

文档质量

14/20

安装易用性

15/20

查看 FMRS 评分方法 →

这是一个社区维护的 Model Context Protocol 服务器，封装 DeepSeek 当前的 V4.1 Flash API。它通过 11 个工具提供文本与图像理解的 Chat Completions、无状态的 Responses API、FIM 补全、Files API 生命周期操作（上传、列表、检索、删除）、模型发现、账户余额查询，以及进程内受限的会话记忆。服务器基于 MCP TypeScript SDK v2 构建，支持 stdio 与 streamable-http 两种传输，并兼容 2026-07-28 协议以及无状态的旧版客户端。注意：此处的“多模态”仅指图像理解，不包含图像、视频或音频生成。该服务器并非 DeepSeek 官方维护，而是由社区开发者发布。

工具能力

chat_completion

文本或视觉 Chat Completions，支持思考控制、函数工具、JSON 输出、流式聚合，以及可选的 conversation_id 记忆。

create_response

无状态 Responses API 调用，支持文本/图像、推理控制、函数与自定义工具、网页搜索、结构化输出和语义流式聚合。

completion

通过 /beta/completions 进行 FIM 补全。

list_models

实时模型发现。

get_user_balance

查询账户可用性与余额。

upload_file

上传 base64 JPEG、PNG、GIF 或 WebP 数据，返回可复用的 DeepSeek file_id。

list_files

按游标、排序和用途筛选列出已上传的文件。

retrieve_file

检索单个 file_id 的元数据。

delete_file

删除一个已上传的文件。

reset_conversation

清除一个本地内存中的会话。

list_conversations

列出本地内存中的会话 ID。

安装接入

需要 Node.js 20 或更高版本。1) 直接通过 stdio 运行：DEEPSEEK_API_KEY="你的密钥" npx -y deepseek-mcp-server@1。2) Claude Code：claude mcp add deepseek --env DEEPSEEK_API_KEY="你的密钥" -- npx -y deepseek-mcp-server@1。3) Codex CLI：codex mcp add deepseek --env DEEPSEEK_API_KEY="你的密钥" -- npx -y deepseek-mcp-server@1。4) 也可在 MCP 客户端配置文件中写入 command 为 npx、args 为 ["-y", "deepseek-mcp-server@1"] 并设置 DEEPSEEK_API_KEY 环境变量。5) 若需本地 HTTP 端点，设置 MCP_TRANSPORT=streamable-http 与 MCP_HTTP_HOST/MCP_HTTP_PORT，默认地址为 http://127.0.0.1:3001/mcp。

claude_desktop_config.json

{
  "mcpServers": {
    "deepseek": {
      "command": "npx",
      "args": ["-y", "deepseek-mcp-server@1"],
      "env": {
        "DEEPSEEK_API_KEY": "REPLACE_WITH_DEEPSEEK_KEY"
      }
    }
  }
}

生成并校验客户端配置

选型与风险

适合谁

需要在 MCP 客户端中集成 DeepSeek V4.1 Flash 的开发者
希望同时使用文本与图像输入的对话或分析工作流
需要自行托管 stdio 或本地 streamable-http 端点的用户

不适合谁

需要图像、视频或音频生成的用户（本服务器仅支持图像理解）
寻找 DeepSeek 官方维护服务器的用户
无法提供 DeepSeek API 密钥或无法访问 DeepSeek API 的环境

所需权限

需要 DEEPSEEK_API_KEY 环境变量，用于向上游 DeepSeek API 发起请求
调用托管端点 https://deepseek-mcp.ragweld.com/mcp 时需要 Authorization: Bearer <token>
upload_file 会将 base64 图像数据上传并存储到你的 DeepSeek 账户下
本地 streamable-http 模式需要监听指定主机与端口，并可配置 MCP_HTTP_ALLOWED_ORIGINS 来源白名单

风险与副作用

upload_file 上传的数据由 DeepSeek 存储在你的账户中，若不设置过期时间或调用 delete_file 会持续保留；过期时间必须在 3600 到 2592000 秒之间
上传内容限制为 64 MiB，并在上传前进行签名校验；upload_file 不接受本地文件路径，也不会在服务器端抓取任意 URL
会话记忆存储在进程内存中，进程重启即清空，CONVERSATION_MAX_MESSAGES 会限制保留的消息总数
托管端点有独立的发布周期，可能落后于 npm/GitHub 版本，使用新工具前应先检查 tools/list
该服务器由社区维护，并非 DeepSeek 官方发布

常见排障

确认 Node.js 版本不低于 20
确认 DEEPSEEK_API_KEY 已正确设置且有效
使用 streamable-http 时检查 MCP_HTTP_HOST、MCP_HTTP_PORT、MCP_HTTP_PATH 配置，默认路径为 /mcp
浏览器客户端带 Origin 请求被返回 403 时，检查 MCP_HTTP_ALLOWED_ORIGINS 是否为精确的逗号分隔白名单
访问托管端点失败时，检查 Authorization 头是否为 Bearer <token> 格式
可运行 DEEPSEEK_API_KEY="密钥" npm run test:live 进行带凭证的冒烟测试

使用场景

让 MCP 客户端直接调用 DeepSeek 进行文本对话与图像理解

需要 FIM 补全的代码或文本填充场景

通过 Files API 上传并复用图像，供多次请求引用

在客户端内查询可用模型列表与账户余额

支持客户端

Claude Code完整支持

Codex CLI完整支持

Claude Desktop完整支持