内容
# 深准 MCP 服务器
> 一个连接任何 MCP 客户端（如 Claude Desktop、Cursor、Cline、Cowork）的简洁服务器，接入 **深准 API**，包括 **DeepSeek-R1** 推理，并展示其思考过程。
<p align="center"><img src="demo.gif" alt="deepseek-mcp-server demo" width="760"></p>
一个 Python 文件，四个工具，无框架锁定。带上您的深准密钥，即可获得快速的 V3 生成、多轮对话和 R1 深度推理，并展示其工作过程 — 直接从您的助手。
## ✨ 工具
| 工具 | 功能 |
|------|--------------|
| `deepseek_generate` | 使用 DeepSeek-V3 进行单轮文本生成（系统指令、温度、JSON 模式） |
| `deepseek_chat` | 多轮对话；切换到 `deepseek-reasoner` 进行逐步思考 |
| `deepseek_reason` | 使用 DeepSeek-R1 处理复杂问题 — 返回推理过程 **和** 答案 |
| `deepseek_list_models` | 列出您的密钥可用的模型 |
## 🚀 快速开始
### 选项 A — 一键安装（Windows，Claude Desktop）
```powershell
# 在仓库文件夹中，右键 install.ps1 -> "用 PowerShell 运行"
./install.ps1
```
它会要求您的 API 密钥，安装依赖项，并连接 Claude Desktop。重启 Claude 即可完成。
### 选项 B — 手动安装（任意操作系统 / 任意 MCP 客户端）
```bash
git clone https://github.com/wilmalunsford1201-prog/deepseek-mcp-server.git
cd deepseek-mcp-server
pip install -r requirements.txt
export DEEPSEEK_API_KEY="您的 API 密钥" # Windows: setx DEEPSEEK_API_KEY "您的 API 密钥"
python deepseek_mcp.py
```
在 <https://platform.deepseek.com/api_keys> 获取 API 密钥。深准的端点与 OpenAI 兼容。
## 🔌 添加到您的 MCP 客户端
复制 `config.example.json`，并将服务器块添加到您的客户端配置文件中，
替换占位符密钥：
```json
{
"mcpServers": {
"deepseek": {
"command": "python",
"args": ["/绝对路径/to/deepseek_mcp.py"],
"env": { "DEEPSEEK_API_KEY": "您的深准 API 密钥" }
}
}
}
```
## 💬 使用示例
- "使用 deepseek 起草一份中文产品更新。"
- "要求 deepseek_reason 解决这个逻辑谜题并展示其推理过程。"
- "使用 deepseek_chat 继续我们的调试对话。"
## 🔐 安全
- 密钥从 `DEEPSEEK_API_KEY` 环境变量中读取 — **绝不硬编码**。
- `config.json` 和 `.env` 被 git 忽略，因此真实的密钥不会被意外提交。
- 如果密钥暴露，请在 [深准控制台](https://platform.deepseek.com/api_keys) 旋转密钥。
## 🛠️ 开发
```bash
pip install -r requirements.txt
python -c "import deepseek_mcp; print(deepseek_mcp.mcp.name)" # 烟雾测试
```
单文件服务器（`deepseek_mcp.py`）：键入 Pydantic 输入，一致的错误
处理，MCP 工具注释。与 [gemini-mcp-server](https://github.com/wilmalunsford1201-prog/gemini-mcp-server) 是 sibling — 相同的清洁形状，不同的提供商。
## 📄 许可证
MIT © 深准。欢迎贡献 — 打开问题或 PR。
