DeepSeek MCP Server

社区

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

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

64FMRS · C

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

最强项 · 安装易用性 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

13/20

维护活跃度

12/20

文档质量

14/20

安装易用性

15/20

查看各项评分依据

可靠性 10/20: 清单声明了 npm 与 OCI 两个包及 streamable-http 远程端点，README 描述了十一个工具、输出 schema、行为注解和 1.0.1 版本变更。但本次为纯静态阅读，没有看到任何 CI 工作流、提交的测试文件或构建产物，所有“credentialed smoke tests”和 live smoke 覆盖只是 README 的自我声明，不可验证。上游 DeepSeek API 被描述为 V4.1 Flash、1M 上下文等未来规格，无法从源文件交叉确认。因此只给出中等分：主路径看起来合理，但缺少可复现的执行证据与错误处理细节，按静态校准上限不超过 12。
安全与权限 13/20: 凭证处理总体干净：DEEPSEEK_API_KEY 与远程 Authorization Bearer 均标记 isSecret/isRequired，安装示例使用 REPLACE_WITH_DEEPSEEK_KEY 占位符而非真实令牌，未触发红线。上传边界有明确限制：仅接受 base64/受支持 data URL、不读取本地路径、不抓取任意 URL、64 MiB 上限、签名校验、3,600–2,592,000 秒过期区间，且 delete_file 属用户显式调用。扣分项：远程托管端点由第三方运营，令牌使用方式与数据流向只是口头声明；文件会在 DeepSeek 账户侧持久化，缺少对敏感图像的提示性确认或最小权限设计；没有提及密钥轮换、审计或传输层细节。未发现恶意、窃取或隐蔽外传，故不判红线，给 13。
维护活跃度 12/20: MIT 许可证存在，仓库标注未归档、0 个未决 issue、352 stars，README 记录了 0.6.0→1.0.1 的迁移说明与依赖升级路径，主题标签齐全，维护迹象积极。但静态源中看不到提交历史、发布节奏、依赖更新机制或安全响应渠道（如 SECURITY.md）；OCI 镜像停留在 0.5.0，与 1.0.1 功能集不一致，说明存在版本漂移；托管端点声明“有自己的发布周期，可能滞后”，治理边界不清。缺失证据按扣分处理，给 12。
文档质量 14/20: 文档层次较完整：安装（npx/Codex/Claude Code）、MCP 客户端 JSON 配置、工具清单与用途、视觉输入示例（URL、base64 data URL、file_id）、上传安全边界、Streamable HTTP 与 Origin 白名单、环境变量表、协议兼容与 0.6.0 迁移、注册表身份、官方参考链接均列出。扣分项：未给出工具级完整参数 schema、错误码/排障章节、成本与限流说明；关键规格（V4.1 Flash、1M 上下文、2026-07-28 协议、SDK v2）无法从源文件验证，属于不可核实的声明；托管部署版本滞后只作模糊提醒。整体可用但存在隐藏假设，给 14。
安装易用性 15/20: 安装路径清晰且步骤少：Node 20+，一条 npx -y deepseek-mcp-server@1 命令即可运行 stdio，另提供 Codex CLI、Claude Code 及通用 JSON 配置示例，HTTP 模式给出主机/端口/来源白名单变量，均为主流客户端可复制的形式。扣分项：托管端点需额外申请 Bearer 令牌且说明可能滞后于 npm 版本；未提供 Docker 运行示例（尽管声明了 OCI 包）；纯静态无法验证 npx 包是否可用，实际连通的验证证据缺失。按校准上限不超过 15，给 15。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要在 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+ · Docker · 远程托管（无需本地环境）

DEEPSEEK_API_KEY 必填密钥调用 DeepSeek 平台 API 所需的密钥，在 DeepSeek 开放平台账户中创建，必填。

其他可选配置项（9 个）

DEEPSEEK_BASE_URL 可选上游 DeepSeek API 地址，默认 https://api.deepseek.com，一般无需修改。

DEEPSEEK_REQUEST_TIMEOUT_MS 可选对 DeepSeek 请求的超时时间（毫秒），默认 120000。

DEEPSEEK_DEFAULT_MODEL 可选默认使用的模型，当前默认 deepseek-flash。

MCP_TRANSPORT 可选传输方式，stdio 或 streamable-http，默认 stdio。

MCP_HTTP_HOST 可选 HTTP 传输的监听主机，默认 127.0.0.1。

MCP_HTTP_PORT 可选 HTTP 传输的监听端口，默认 3001。

MCP_HTTP_PATH 可选 HTTP 端点路径，默认 /mcp。

MCP_HTTP_ALLOWED_ORIGINS 可选浏览器客户端的来源白名单（逗号分隔），带 Origin 头且不在名单内的请求会被 403 拒绝。

CONVERSATION_MAX_MESSAGES 可选进程内会话存储保留的最大消息数，默认 200。

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

.mcp.json

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

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

.vscode/mcp.json

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

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

Terminal

claude mcp add deepseek -e DEEPSEEK_API_KEY=REPLACE_WITH_DEEPSEEK_KEY -- npx -y deepseek-mcp-server@1

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

生成并校验客户端配置

验证是否装好

在客户端的工具列表中应出现 chat_completion、list_models、get_user_balance 等 11 个工具；运行 list_models 或 get_user_balance 并得到真实模型列表或余额数据，即可证明连接正常。

常见排障

确认 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 进行带凭证的冒烟测试

试试这样问

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

用 chat_completion 描述这张图片：https://example.com/photo.png
调用 list_models 看看当前有哪些 DeepSeek 模型可用
上传一张 PNG 图片，然后用它的 file_id 让我解释图里的内容
查一下我的 DeepSeek 账户余额和可用性

工具能力 11

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 的元数据。

展开其余 3 个工具

delete_file 破坏性

删除一个已上传的文件。

reset_conversation 写入

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

list_conversations 只读

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

使用场景

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

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

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

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

支持客户端

Claude Code

Codex

Claude Desktop

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

详细介绍

这是一个社区维护的 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 官方维护，而是由社区开发者发布。