DeepSeek Role Translator

HTTP 代理 + MCP 服务器。解决 Android Studio 的 Gemini/Claude 等 AI 插件发送 developer 角色给 DeepSeek API 时报错的问题——自动把 developer 翻译成 DeepSeek 认识的 system。

原理

Android Studio ──(developer)──▶ localhost:8765 ──(system)──▶ api.deepseek.com
Android Studio ◀─────────────────────────────────────────────── api.deepseek.com

代理在本地拦截所有 /v1/chat/completions 请求，把 messages 里的 developer 角色替换成 system，其余字段原样透传。同时暴露 MCP 端点，供 Android Studio 发现和调用。

使用步骤

1. 安装依赖

pip install -r requirements.txt

2. 配置 API Key

复制 .env.example 为 .env，填入 DeepSeek API key 和模型：

DEEPSEEK_API_KEY=sk-your-deepseek-api-key
DEEPSEEK_MODEL=deepseek-v4-pro

模型可选 deepseek-v4-pro 或 deepseek-v4-flash。

3. 启动服务器

双击 run_http.bat，或在终端运行：

python server.py --http

看到以下输出表示启动成功：

代理 + MCP 已启动: http://localhost:8765
  代理端点:     http://localhost:8765/v1
  MCP 端点:     http://localhost:8765/mcp
INFO:     Uvicorn running on http://127.0.0.1:8765

窗口保持开着，不要关。

4. 配置 Android Studio

两步都要做：

① 导入 MCP 配置

Settings → MCP → Import JSON file → 选择项目里的 mcp-config.json。看到 Successfully connected to MCP server DeepSeek Translator 即完成。

② 配置 AI Provider

Settings → AI Provider（或你使用的 AI 插件设置），添加一个新的 provider：

字段	值
URL Schema	OpenAI / OpenAI Compatible
Base URL	http://localhost:8765/v1
API Key	和 .env 里一样的 DeepSeek key
Model	deepseek-v4-pro 或 deepseek-v4-flash

关键：Base URL 必须是 http://localhost:8765/v1，不是 https://api.deepseek.com。这样请求才会经过本地代理做角色翻译。

5. 使用

正常在 Android Studio 里用 AI 聊天即可，角色翻译在后台自动完成，完全无感。

验证

启动服务器后，如果看到终端输出以下日志，说明代理正在工作：

GET /v1/models HTTP/1.1 200 OK
POST /v1/chat/completions HTTP/1.1 200 OK

常见问题

Q: 提示 unknown variant developer？

AI Provider 的 Base URL 没有指向本地代理，还是直连的 DeepSeek。确认 Base URL 是 http://localhost:8765/v1。

Q: 提示 UNAVAILABLE: io exception？

服务器没启动。双击 run_http.bat 启动。

Q: 改了 .env 需要重启吗？

需要。关掉 run_http.bat 窗口，重新打开。

文件结构

├── server.py          # 代理 + MCP 服务器
├── run_http.bat       # Windows 一键启动脚本
├── mcp-config.json    # Android Studio MCP 配置（导入用）
├── requirements.txt   # Python 依赖
├── .env.example       # 配置模板
└── .env               # API key（不提交 git）