DMontgomery40/deepseek-mcp-server

DeepSeek MCP 服务器 – 概述

DeepSeek MCP 服务器 是一个小型的 Node.js 程序，充当模型上下文协议 (MCP) 与 DeepSeek 的 V4.1 Flash 和 V4 Pro 语言模型 API 之间的桥梁。实际上，它让理解 MCP 的工具（例如 Claude、Codex 或自定义的 MCP 兼容客户端）能够与 DeepSeek 通信，而无需每个客户端都实现 DeepSeek 自己的 HTTP API。

核心功能

功能	工作方式	获得的效果
聊天补全	向 DeepSeek 发送 `/v1/chat/completions` 请求（或 beta 端点），可选附带图像。	文本回复、JSON 结构化输出、流式传输以及可选的内存对话记忆（`conversation_id`）。
Responses API	调用 DeepSeek 的 Responses 端点，可以返回文本或图像。	可包含自定义工具 `apply_patch` 和结构化输出的无状态调用。
FIM 补全	使用 DeepSeek 的 `/beta/completions` 端点进行中间填充（fill-in-the-middle）生成。	支持可选流式传输的文本补全，输出令牌限制约 4K。
模型发现与余额	封装 DeepSeek 的 `/models` 和 `/balance` 端点。	列出可用模型及其限制，并显示您的账户信用。
文件 API	在 DeepSeek 存储上上传、列出、检索和删除图像文件。	可重复使用的 `file_id` 用于视觉输入，大小限制（每个文件 64 MiB）。
对话记忆	在每个 `conversation_id` 的进程中短暂存储最近的消息。	无需每次请求重新发送完整历史记录即可继续聊天。
速率限制与认证	可选 HTTP 传输的简单基于令牌的认证以及全局工具速率限制。	防止意外过度使用您的 DeepSeek 配额。

运行方式

STDIO 模式（默认） – 使用 npx deepseek-mcp-server@1 启动，并通过 stdin/stdout 传输 MCP JSON 消息。适合本地 CLI 工具。
HTTP 模式 – 设置 MCP_TRANSPORT=streamable-http 并指定主机/端口。服务器随后在 http://127.0.0.1:3001/mcp 监听，可从浏览器或其他服务调用。

两种模式都只需要一个环境变量：DEEPSEEK_API_KEY。

谁会使用它？

构建 MCP 感知助手的开发者（Claude、Codex 等）– 希望使用 DeepSeek 作为后端，而无需编写 DeepSeek 特定请求代码。
RAG 或多模态管道 – 需要向 DeepSeek 的视觉模型发送图像；服务器为您处理文件上传生命周期。
测试或原型设计 – npm 包附带一个实时冒烟测试套件，可针对真实 DeepSeek 账户测试所有工具。

它不做什么

它永远不会生成图像、视频或音频 – 只进行文本和图像理解。
它不是针对任意 OpenAI 兼容 API 的全功能网关；仅实现 DeepSeek 当前提供的端点。

快速开始（复制粘贴）

# 1️⃣ 安装/运行（需要 Node 20+）
DEEPSEEK_API_KEY=YOUR_KEY npx -y deepseek-mcp-server@1

# 2️⃣ MCP 客户端配置示例（JSON）
{
  "mcpServers": {
    "deepseek": {
      "command": "npx",
      "args": ["-y", "deepseek-mcp-server@1"],
      "env": {"DEEPSEEK_API_KEY": "YOUR_KEY"}
    }
  }
}

现在，任何 MCP 兼容客户端都可以通过 deepseek 服务器调用 chat_completion、list_models 或 upload_file 等工具。

了解更多

官方 DeepSeek 文档 – README 中有模型限制、定价和视觉指南的链接。
MCP 规范（2026-07-28） – 该服务器实现的协议。
GitHub 仓库 – 包含完整源代码、测试和审计文档（docs/research/...）。

许可证

MIT – 您可以自由使用、修改和重新分发该服务器。