🚀 Deepseek R1 MCP 服务器

Deepseek R1 MCP 服务器是 Deepseek R1 语言模型的 Model Context Protocol (MCP) 服务器实现。Deepseek R1 是一款强大的语言模型，专为推理任务设计，拥有 8192 个令牌的上下文窗口，能有效处理复杂的文本任务。

🚀 快速开始

使用 Smithery 安装

你可以通过 Smithery 自动安装 Deepseek R1，以供 Claude Desktop 使用：

npx -y @smithery/cli install @66julienmartin/mcp-server-deepseek_r1 --client claude

手动安装

# 克隆代码并安装
git clone https://github.com/66julienmartin/MCP-server-Deepseek_R1.git
cd deepseek-r1-mcp
npm install

# 设置环境
cp .env.example .env  # 然后添加你的 API 密钥

# 构建并运行
npm run build

✨ 主要特性

• 使用 Deepseek R1 的高级文本生成（上下文窗口大小为 8192），能够处理长文本输入和输出。
• 可配置参数（max_tokens、temperature），满足不同场景的需求。
• 健壮的错误处理和详细的错误消息，方便调试和维护。
• 完整的 MCP 协议支持，确保与其他系统的兼容性。
• Claude Desktop 集成，无缝对接使用。
• 支持 DeepSeek - R1 和 Deepseek - V3 模型，提供更多选择。

📦 安装指南

先决条件

• Node.js (v18 或更高版本)
• npm
• Claude Desktop
• Deepseek API Key

安装步骤

按照上述快速开始中的使用 Smithery 安装或手动安装步骤进行操作。

💻 使用示例

基础用法

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

// 使用 Deepseek - R1（默认）
model: "deepseek - reasoner"

// 使用 Deepseek - V3
model: "deepseek - chat"

高级用法

{
  "name": "deepseek_r1",
  "arguments": {
    "prompt": "Your prompt here",
    "max_tokens": 8192,  // 最大生成令牌数
    "temperature": 0.7   // 创造性参数，范围在 0 到 1 之间
  }
}

📚 详细文档

模型选择

默认使用 deepseek - R1 模型，若要使用 DeepSeek - V3，在 src/index.ts 中修改模型名称。

项目结构

deepseek - r1 - mcp/
├── src/
│   ├── index.ts             # 主服务器实现文件
├── build/                   # 编译后的文件
│   ├── 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     # 监视模式
npm run build   # 构建生产版本

温度参数最佳实践

错误处理

• 输入验证错误：返回 400 Bad Request
• 服务器内部错误：返回 500 Internal Server Error

🔧 技术细节

选择 Node.js 的原因

此实现使用 Node.js/TypeScript，因为它与 MCP 服务器提供了最稳定的集成。Node.js SDK 提供了更好的类型安全、错误处理和与 Claude Desktop 的兼容性。

📄 许可证

本项目采用 MIT License。

贡献信息

欢迎贡献！请参考 [CONTRIBUTING.md](https://github.com/your - repository/CONTRIBUTING.md)。