金大哥 - 66julienmartin_MCP-server-Deepseek

article

README

🚀 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 安装和手动安装的步骤。

💻 使用示例

基础用法

此服务器的 API 使用示例如下：

{
  "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（默认）
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=your-api-key-here

更新 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   # 构建生产版本

温度参数最佳实践

| 使用场景 | 推荐温度值 | 示例 | |------------------|------------|----------------------------------------| | 创作 | 0.7 | 高创造性的文本生成 | | 理解与解释 | 1.0 | 文本摘要或对话生成 | | 代码生成 | 0.5 | 更加确定性的代码生成 |

错误处理

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

贡献信息

欢迎贡献！请参考 CONTRIBUTING.md。

📄 许可证

MIT License

66julienmartin_MCP-server-Deepseek_R1