DeepSeek MCP Server 是一个面向 DeepSeek V4 的 MCP（Model Context Protocol）服务器，为兼容 MCP 的客户端提供聊天、推理、函数调用、思考模式与成本追踪能力。
主要能力
模型支持：v2.0.0 基于 DeepSeek V4，提供 deepseek-v4-flash（快速经济）与 deepseek-v4-pro（最强能力）两个模型，均具备 1M token 上下文窗口和可选的思维链思考模式。原有的 deepseek-chat 和 deepseek-reasoner 配置通过已弃用别名继续可用，升级为直接替换，但新配置应使用 V4 名称。
多轮会话：通过 session_id 参数在请求之间保留对话上下文。
模型回退与熔断：模型遇到可重试错误（429、503、超时）时自动回退到另一模型，并设有熔断保护防止级联故障。
MCP 资源：提供 deepseek://models、deepseek://config、deepseek://usage，可查询模型信息、配置和使用统计。
思考模式：通过 thinking: {type: "enabled"} 在任一 V4 模型上启用思维链推理。
JSON 输出模式：通过 json_mode: true 获得结构化 JSON 响应。
Schema 校验 JSON：传入 response_schema 后服务器会校验输出，带有界修复重试和针对 schema 模式的 ReDoS 防护。
函数调用：兼容 OpenAI 的工具使用，最多支持 128 个工具定义。
Fill-in-the-Middle（FIM）：通过 deepseek_fim 工具在前后缀之间补全代码和内容。
缓存感知成本追踪：自动计算成本，并提供缓存命中/未命中明细。
会话管理工具：通过 deepseek_sessions 工具列出、删除和清除会话。
其他特性：基于环境变量的可配置与校验、12 个提示词模板、流式响应、多模态就绪（通过 ENABLE_MULTIMODAL=true 启用文本+图像输入）、远程端点、HTTP 传输、Docker 就绪、340 项测试约 92% 行覆盖率、完整 TypeScript 类型安全实现。
使用方式
远程使用（无需安装）：直接使用托管端点，无需 npm install 和 Node.js，携带自己的 DeepSeek API key 即可。适用于 Cursor / Windsurf / VS Code。Claude Code 提供 -s user、-s local、-s project 三种范围选项。API key 获取地址：https://platform.deepseek.com。
手动安装：克隆仓库、安装依赖、构建项目。配置完成后，MCP 客户端可使用 deepseek_chat、deepseek_fim 和 deepseek_sessions 工具，以及 3 个 MCP 资源。
手动配置（高级）：若客户端不支持 add 命令，可手动添加到配置文件。Claude Code 的配置文件位于 ~/.claude.json（添加到 projects["your-project-path"].mcpServers 部分）；其他 MCP 客户端请查阅其文档。
可用工具
deepseek_chat：与 DeepSeek AI 模型聊天，支持自动成本追踪和函数调用。参数包括 messages（必填，含 role、content、tool_call_id）、model、temperature、max_tokens、stream、tools、tool_choice、thinking、reasoning_effort、json_mode、response_schema、session_id。响应包含格式化内容、函数调用结果、请求信息（token、模型、美元成本），以及 structuredContent 下的 request、effective、fallback、schema 等字段。
deepseek_fim：Fill-in-the-Middle 补全，用于代码补全和内容填充而非对话，运行在 DeepSeek Beta 端点、非思考模式，API 输出上限 4096 token。参数包括 prompt（必填）、suffix、model、max_tokens、temperature、stop。
deepseek_sessions：管理会话，action 支持 list、clear、delete，delete 时需 session_id。
模型能力与定价
两个 V4 模型均具备 1M token 上下文窗口、最高 384K 输出 token，支持函数调用、JSON 模式和可选思维链，默认非思考模式以获得快速响应。
deepseek-v4-flash（默认）：适合一般对话、编码、内容生成、智能体循环；快速经济；定价为缓存命中 $0.0028/1M、缓存未命中 $0.14/1M、输出 $0.28/1M。
deepseek-v4-pro：适合复杂推理、数学、困难多步任务、最高质量输出；速度较 flash 慢，能力最高；定价为缓存命中 $0.003625/1M、缓存未命中 $0.435/1M、输出 $0.87/1M。
已弃用别名 deepseek-chat 和 deepseek-reasoner 仍被接受，分别解析为 deepseek-v4-flash 的非思考/思考模式，下次主版本发布将移除。DeepSeek API 本身于 2026-07-24 停用这两个名称。
回退与熔断机制
模型遇到可重试错误时自动回退：deepseek-v4-flash 失败则尝试 deepseek-v4-pro，反之亦然。熔断器在连续失败达到阈值（默认 5 次）后进入快速失败模式，等待 CIRCUIT_BREAKER_RESET_TIMEOUT 毫秒（默认 30000）后进入半开状态发送探测请求，成功则关闭熔断恢复正常。可通过 FALLBACK_ENABLED=false 禁用回退。
提示词模板
内置 12 个模板：debug_with_reasoning、code_review_deep、research_synthesis、strategic_planning、explain_like_im_five、mathematical_proof、argument_validation、creative_ideation、cost_comparison、pair_programming、function_call_debug、create_function_schema。每个模板针对思考模式优化。
部署与配置
通过环境变量配置，除 DEEPSEEK_API_KEY 外均为可选。
远程端点（托管）：提供 BYOK 端点 deepseek-mcp.tahirl.com/mcp，通过 Authorization: Bearer <key> 发送 DeepSeek API key，服务端不存储密钥，由 Cloudflare Workers 驱动（全球边缘、零冷启动）。注意思考模式对复杂查询可能超过 30 秒，部分 MCP 客户端（如 Claude Code）有内置工具调用超时可能中断长请求。
HTTP 传输（自托管）：可运行自己的 HTTP 端点，MCP 端点位于 POST /mcp（Streamable HTTP 协议）。自托管 HTTP 模式下服务器持有 DEEPSEEK_API_KEY 并用于每次 deepseek_chat 调用，任何能访问 POST /mcp 的人都能调用工具并消耗该密钥。HTTP_HOST 默认 127.0.0.1，仅监听回环且 SDK 的 DNS 重绑定保护生效。若要接受远程连接，需设置 HTTP_HOST=0.0.0.0 并配置 HTTP_AUTH_TOKEN 或 HTTP_ALLOWED_HOSTS。仅绑定 0.0.0.0 而不配置两者会关闭 SDK 的 Host 头检查，使 /mcp 暴露于 DNS 重绑定风险，服务器会拒绝以该方式启动。
适用场景
适用于需要将 DeepSeek V4 聊天与推理能力接入 MCP 兼容客户端（如 Claude Code、Gemini CLI、Cursor、Windsurf）的开发者和用户，支持多轮对话、函数调用、代码补全、结构化输出与成本追踪等场景。
