Deepseek R1 MCP Server

Deepseek R1 MCP 服务

面向 Deepseek R1 语言模型的模型上下文协议（MCP）服务实现。Deepseek R1 是一款强大的语言模型，针对推理任务进行了优化，拥有 8192 个 token 的上下文窗口。

为什么选择 Node.js？ 此实现使用 Node.js/TypeScript，因为它能为 MCP 服务提供最稳定的集成。Node.js SDK 提供更好的类型安全性、错误处理能力，并与 Claude Desktop 具有更好的兼容性。

快速开始

手动安装

# Clone and install
git clone https://github.com/66julienmartin/MCP-server-Deepseek_R1.git
cd deepseek-r1-mcp
npm install

# Set up environment
cp .env.example .env  # Then add your API key

# Build and run
npm run build

前提条件

• Node.js（v18 或更高版本）
• npm
• Claude Desktop
• Deepseek API 密钥

模型选择

默认情况下，此服务使用 deepseek-R1 模型。如果要改用 DeepSeek-V3，请在 src/index.ts 中修改模型名称：

// For DeepSeek-R1 (default)
model: "deepseek-reasoner"

// For DeepSeek-V3
model: "deepseek-chat"

项目结构

deepseek-r1-mcp/
├── src/
│   ├── index.ts             # Main server implementation
├── build/                   # Compiled files
│   ├── index.js
├── LICENSE
├── README.md
├── package.json
├── package-lock.json
└── tsconfig.json

配置

1. 创建 .env 文件：

DEEPSEEK_API_KEY=your-api-key-here

2. 更新 Claude Desktop 配置：

{
  "mcpServers": {
    "deepseek_r1": {
      "command": "node",
      "args": ["/path/to/deepseek-r1-mcp/build/index.js"],
      "env": {
        "DEEPSEEK_API_KEY": "your-api-key"
      }
    }
  }
}

开发

npm run dev     # Watch mode
npm run build   # Build for production

功能

• 使用 Deepseek R1 进行高级文本生成（8192 个 token 的上下文窗口）
• 可配置参数（max_tokens、temperature）
• 完善的错误处理，并提供详细的错误消息
• 完整支持 MCP 协议
• 集成 Claude Desktop
• 支持 DeepSeek-R1 和 DeepSeek-V3 两种模型

API 用法

{
  "name": "deepseek_r1",
  "arguments": {
    "prompt": "Your prompt here",
    "max_tokens": 8192,    // Maximum tokens to generate
    "temperature": 0.2     // Controls randomness
  }
}

temperature 参数

temperature 的默认值为 0.2。

Deepseek 建议根据具体用例设置 temperature：

用例	温度	示例
编码 / 数学	0.0	代码生成、数学计算
数据清理 / 数据分析	1.0	数据处理任务
日常对话	1.3	聊天与对话
翻译	1.3	语言翻译
创意写作 / 诗歌	1.5	故事写作、诗歌生成

错误处理

此服务会针对常见问题提供详细的错误消息：

• API 身份验证错误
• 参数无效
• 速率限制
• 网络问题

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT