JinDaGe - MCP-server-Deepseek

article

README

🚀 Deepseek R1 MCP 服务器

Deepseek R1 是一款功能强大的语言模型，专为推理任务量身打造，具备 8192 个令牌的上下文窗口。本实现采用 Node.js/TypeScript，因其能与 MCP 服务器实现最稳定的集成。Node.js SDK 提供了更出色的类型安全、错误处理能力，以及与 Claude Desktop 的兼容性。

🚀 快速开始

手动安装

# 克隆和安装
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

📋 先决条件

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

🎯 模型选择

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

// 对于 Deepseek-R1 (默认)
model: "deepseek-reasoner"

// 对于 DeepSeek-V3
model: "deepseek-chat"

📁 项目结构

deepseek-r1-mcp/
├── src/
│   ├── index.ts             # 主服务器实现文件
├── build/                   # 编译后的文件
│   ├── index.js
├── LICENSE
├── README.md
├── package.json
├── package-lock.json
└── tsconfig.json

⚙️ 配置

创建一个 .env 文件：

DEEPSEEK_API_KEY=你的 API 密钥

更新 Claude Desktop 配置：

{
  "mcpServers": {
    "deepseek_r1": {
      "command": "node",
      "args": ["/path/to/deepseek-r1-mcp/build/index.js"],
      "env": {
        "DEEPSEEK_API_KEY": "你的 API 密钥"
      }
    }
  }
}

💻 开发

npm run dev     # 监视模式
npm run build   # 构建生产环境

✨ 主要特性

运用 Deepseek R1 进行高级文本生成（8192 令牌上下文窗口）
可配置参数（max_tokens，temperature）
具备详细错误消息的健壮错误处理机制
完全支持 MCP 协议
与 Claude Desktop 集成
支持 DeepSeek-R1 和 DeepSeek-V3 模型

📚 API 使用说明

{
  "name": "deepseek_r1",
  "arguments": {
    "prompt": "你的提示语句",
    "max_tokens": 8192,    // 最大生成令牌数
    "temperature": 0.2     // 温度参数
  }
}

🌡️ 温度参数说明

| 属性 | 详情 | |------|------| | 创造性任务（如写文章、诗歌） | 温度参数值高于 1（例如 1.2 或 1.5） | | 稳定性任务（如代码生成、数学计算） | 温度参数值接近 0（例如 0.3 或 0.5） | | 平衡模式 | 温度参数默认值为 1 |

🔧 错误处理

错误：API 密钥无效
- 检查 .env 文件中的 DEEPSEEK_API_KEY 是否正确。
错误：无法连接到服务器
- 确保服务器已启动并在运行。
错误：模型未加载
- 检查 src/index.ts 中的模型名称是否配置正确。

💻 使用示例

基础用法

npm install
node src/index.js

输入提示语句：

"告诉我一些创意写作的技巧。"

输出结果：

{
  "response": "1. 使用生动的语言和具体的细节来描绘场景。\n2. 多读优秀作品以获取灵感。\n3. 练习日常写作以提高技能。"
}

📝 总结

通过上述步骤，你能够轻松配置并运行 Deepseek R1 MCP 服务器，借助其强大的语言模型开展各类文本生成任务。

MCP-server-Deepseek_R1