国产模型 MCP 服务器

CN Model Gateway 是一个纯 Python、零运行时依赖的国产大模型统一 MCP 服务器。它启动后通过 stdio 暴露标准 JSON-RPC 2.0 接口，让任何兼容 MCP 的 Agent 框架（Claude Code、Cursor、Cline、n8n、Claude Desktop 等）一站式调用 DeepSeek、通义千问、智谱 GLM、Kimi、腾讯混元、火山豆包、MiniMax、零一万物、百川智能、阶跃星辰十家模型。

核心定位：只做 MCP 协议网关。

• ❌ 不做本地模型推理 / GPU 部署
• ❌ 不做模型微调 / 训练
• ❌ 不做私有部署版 SaaS
• ✅ 只做标准 MCP 协议接口，把各家模型统一封装成 MCP tools/resources/prompts

适用场景

安装

前提条件

• Python 3.9+（已安装在你系统上）
• 至少一个国产模型的 API key

安装步骤

# 1. 克隆或下载本 skill 文件夹
git clone https://github.com/your-org/cn-model-gateway.git
cd cn-model-gateway

# 2. 复制配置模板，填写你的 api_key
cp config/config.json.example config/config.json
# 然后编辑 config.json，填入你的 api_key

无需 pip install，所有代码使用 Python 标准库（urllib/json/sqlite3/asyncio）。

使用方法

方式一：作为 MCP 服务器（推荐，给 Claude Code / Cursor / Cline 用）

在 Claude Code / Cursor / Cline 的 MCP 配置文件中加入：

{
  "mcpServers": {
    "cn-model-gateway": {
      "command": "python",
      "args": ["D:/skill/cn-model-gateway/main.py", "run", "-c", "D:/skill/cn-model-gateway/config/config.json"]
    }
  }
}

启动 Agent 框架后，即可自动发现 4 个工具 + 2 个资源 + 2 个 prompt 模板。

方式二：命令行直接提问

# 直接提问（自动选择可用模型）
python main.py ask "写一个快速排序"

# 指定模型提问
python main.py ask "写一个快速排序" -p deepseek

# 对比多个模型
python main.py compare "解释量子计算" -p deepseek tongyi zhipu

# 查看已配置模型状态
python main.py status

# 查看使用统计
python main.py stats

# 启动 MCP 服务器
python main.py run

方式三：Python API 直接调用

from src.router import ModelRouter
from src.adapters.base import ChatMessage

router = ModelRouter()
router.register_all({
    "deepseek": {"api_key": "sk-xxx"}
})

msgs = [ChatMessage(role="user", content="你好")]
resp = router.chat(msgs, provider="deepseek")
print(resp.content)

内置工具（MCP tools/list 返回）

内置资源（MCP resources/list 返回）

内置 Prompt 模板（MCP prompts/list 返回）

配置说明

config.json 格式：

{
  "deepseek": { "api_key": "sk-xxx" },
  "tongyi": { "api_key": "sk-xxx" },
  "zhipu": { "api_key": "your-key" },
  "kimi": { "api_key": "your-key" },
  "hunyuan": { "api_key": "SECRET_ID:SECRET_KEY" },
  "doubao": { "api_key": "your-key" }
}

• 可以只填一家，也可以六家全填
• hunyuan 比较特殊，格式为 secret_id:secret_key（冒号分隔）
• 未填 api_key 的提供商自动标记为不可用，不影响其他家使用

统一错误映射

各家模型返回的错误码不同，本 skill 统一映射为 MCP 标准错误码：

所有错误信息均为中文，便于排查。

性能优化

• 硬件感知并发：启动时自动采集 CPU 核数和内存大小，低配电脑（< 4GB 内存）限制并发数为 1，高配最多 4 并发
• 零外部依赖：纯 Python 标准库，无 pip install，避免环境污染
• 流式输出：长对话走 SSE 流式，不堵内存
• SQLite 本地统计：调用记录本地落盘，无网络上传

版本更新提醒

本 skill 会在每次启动时打印当前版本号（stderr）。要获取最新版本：

# 检查 GitHub 最新版本（需安装 gh CLI）
gh release list --repo your-org/cn-model-gateway

建议关注本 skill 的 GitHub Release 页获取更新通知。

⚠️ 风险项（必读）

能力边界

• 仅支持文本对话（chat completions），不支持图片/音频/视频理解
• 不支持 Function Calling / Tool Use（各家实现差异大，暂不统一封装）
• 不支持本地模型推理或 GPU 部署
• 不支持 model cascade / fallback（auto 模式只随机选一家，不自动重试）
• 不支持批量异步调用（single-call synchronous only）

常见问题（FAQ）

Q: 为什么启动后没有任何提供商可用？ A: 检查 config.json 格式是否正确，api_key 是否填写。运行 python main.py status 查看状态。注意 hunyuan 格式是 secret_id:secret_key（冒号分隔）。

Q: 能同时配置多个提供商让 skill 自动选择吗？ A: 可以。auto 模式会随机选一家可用的。如果要稳定输出，建议显式指定 -p deepseek。

Q: 各家模型的默认模型是什么？ A: deepseek-chat / qwen-turbo / glm-4-flash / moonshot-v1-8k / hunyuan-standard / doubao 系列。可通过 model 参数覆盖。

Q: 使用量数据存在哪里？ A: 默认存储在 ~/.cn-model-gateway/usage.db（SQLite）。不会上传到任何服务器。

Q: 支持哪些操作系统？ A: Windows / macOS / Linux 全平台支持。需要 Python 3.9+。

Q: 需要 GPU 吗？ A: 完全不需要。本 skill 只做 API 网关，不进行本地推理。

支持与反馈

有更好建议：njskills@agent.qq.com

遇到问题请提供：

1. python main.py status 输出
2. 报错截图或完整错误信息
3. 你使用的 model provider 名称

更新日志

| v1.2.0 | 2026-07-24 | 新增 5 个非 MCP 框架适配器（LangChain Tool、AutoGPT Plugin、CrewAI Tool、Coze 插件、Dify 工具节点）；扩展框架适配层从 MCP 生态到全 Agent 生态；新增 frameworks 模块（5 个适配器 + 统一导出）；测试覆盖新增 11 个框架适配器单元测试（总计 29 tests） |

| v1.1.0 | 2026-07-17 | 新增 4 家模型提供商（MiniMax/零一万物/百川智能/阶跃星辰）；更新 DeepSeek-V3 支持（deepseek-chat, deepseek-reasoner）；更新 Kimi 新版本（moonshot-v1-32k, moonshot-v1-128k）；扩展统一错误映射覆盖 10 家厂商；支持模型表格同步更新 | | v1.0.0 | 2026-07-16 | 初始版本发布，包含：MCP JSON-RPC 2.0 完整协议适配（tools/list/call + resources/list/read + prompts/list/get）；6 家国产模型适配器（DeepSeek/通义/智谱/Kimi/混元/豆包）；统一错误映射（4 种 MCP 标准错误码 + 中文 message）；流式 SSE 输出；本地 MCP 服务器 stdio 启动；内置 4 个工具（ask_model/compare_models/list_providers/health_check）；2 个 prompt 模板（code_review/translate）；使用量统计（SQLite + 周报）；硬件感知并发控制（自动采集 CPU/内存 → 动态分配并发数）；纯 Python 标准库零依赖；CLAUDE.md/Cursor/Cline 配置文件模板 |