
joeseesun/qiaomu-llm-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Провайдер HeavySkill MCP | Локальный шлюз MCP для многопрофильной маршрутизации LLM, секретов и обсуждений HeavySkill.
Обзор
Локальный шлюз MCP, который превращает многих поставщиков LLM, ключи API, правила маршрутизации и многомодельные обсуждения в одну поверхность инструмента. - Z.ai Coding Plan DeepSeek OpenAI-совместимый API Anthropic-совместимый API Код API ClaudeCLI Anthropic ClaudeCLI ClaudeCLI ClaudeCLI ClaudeCodeCLI ClaudeCodex Codex - Кодекс 在Кодекс Кодекс Кодекс Кодекс Кодекс Кодекс Кодекс Кодекс Кодекс Кодекс Кодекс Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс工Кодекс Производитель: ~/.config/qiaomu-llm/registry.json, chev macOS Keychain,MCP-сервер « chev», НАСТОЯЩИЙСЯ 型 НАСТОЯЩИЙ, НАСТОЯЩИЙ, НАСТОЯЩИЙ, 写 НАСТОЯЩИЙ, 写 НАСТОЯЩИЙ, КОДЕКС НАСТОЯЩИЙ НАСТОЯЩИЙ - macOS Linux - Python 3.10+ - MCP Codex Claude Desktop Claude Code Cursor - LLM Provider API Key MCP сервер stdio MCP , ~/.config/qiaomu-llm/registry.json, Z.ai Coding Plan - конечная точка кодирования:
Обзор (машинный перевод)
多 LLM Provider
Локальный шлюз MCP, который превращает многих провайдеров LLM, ключи API, правила маршрутизации и обсуждения нескольких моделей в одну поверхность инструмента.
中 |* Английский
景 景 Информирование:
- Z.ai Coding Plan DeepSeek OpenAI-совместимый API Anthropic-совместимый API Claude Code CLI
- API Ключ Кодекс
- chev Codex/Claude/ MCP 一 Combinance :
- НАСТОЯЩИЕ НАСТОЯЩИЕ 主, Провайдер
Производитель: ~/.config/qiaomu-llm/registry.json, macOS Keychain, MCP-сервер « chev»,
, MCP Инфункционал :
[править править код]
[править править код]
qllm_list_providers qllm_list_providers qllm_list_providers qllm_list_providers qllm_list_providers qllm_list_providers] qllm_list_providers qllm_list_providers] qllm_list_providers qllm_list_providers] qllm_list_providers] qllm_list_providers] qllm_list_providers qllm_list_providers] qllm_list_providers] qllm_list_providers] qllm_list_providers] qllm_list_providers] qllm_list_providers] qllm_list_providers] qllm_list_providers [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]
[[Т2]] | Провайдер
[[Т3]] [[Т4]]] [[Т4]] [[Т]]] [[Т]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]]] [[Т]]] [[Т]] [Т[Т]]] [[Т]]] [[Т]]] [Т[Т]]] [[Т]]] [[Т]] [Т]] [Т[Т]]] [Т[Т]]] [Т[Т]]] [Т[Т]]] [Т[Т]]] [Т[Т]]] [Т[Т]]]
qllm_route_task qllm_route_task qllm_route_task] qllm_route_task] qllm_route_task [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]]] [T[T]] Провайдер / Модель
[6][править править код]
qllm_compare qllm_compare qllm_compare qllm_compare qllm_compare qllm_compare] qllm_compare qllm_compare] qllm_compare [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [
qllm_pipeline qllm_pipeline qllm_pipeline] qllm_pipeline qllm_pipeline] qllm_pipeline qllm_pipeline] qllm_pipeline] qllm_pipeline qllm_pipeline] [[T]]]
qllm_heavy_discuss qllm_heavy_discuss qllm_heavy_discuss qllm_heavy_discuss] qllm_heavy_discuss qllm_heavy_discuss] qllm_heavy_discuss [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]] [T[T]]] [[T]] [T[T]]] [T[T]] [T[T]]] [T[T]]] [[T]] [T[T]]] [T[T]] [T]] [T[T]] [T[T]]] [T[T]] [T[T]] [
| qllm_heavy_render | Codex {\displaystyle }} Markdown / HTML |
qllm_claude_code_* | MCP {\displaystyle CLI}
工 工 工
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
qiaomu-llm-mcp
把多个 LLM Provider、API Key、模型路由和多模型讨论统一成一个本地 MCP 网关。 A local MCP gateway that turns many LLM providers, API keys, routing rules, and multi-model discussions into one tool surface.
中文 | English
适合这些场景:
- 你同时使用 Z.ai Coding Plan、DeepSeek、OpenAI-compatible API、Anthropic-compatible API、Claude Code CLI 等多套模型。
- 你不想把 API Key 写进提示词、脚本或 Codex 配置里。
- 你希望在 Codex / Claude / 其他 MCP 客户端里用同一组工具完成:单模型调用、多模型对比、流水线、HeavySkill 式多轮讨论。
- 你需要让最强的主控模型主持讨论,而不是把全部判断交给某一个 Provider。
本项目是本地优先工具:Provider 注册表保存在 ~/.config/qiaomu-llm/registry.json,密钥默认放在 macOS Keychain,MCP server 只暴露“密钥是否存在”,不会返回明文 Key。
你能得到什么
安装后,MCP 客户端会看到这些工具:
| 工具 | 作用 |
|---|---|
qllm_list_providers |
列出本地配置的 Provider,并安全显示密钥状态 |
qllm_show_provider |
查看单个 Provider 的非敏感配置 |
qllm_list_models |
查看本地配置或远程 /models 返回的模型 |
qllm_route_task |
不花 token,根据任务类型选择 Provider / Model |
qllm_chat |
调用单个 Provider |
qllm_compare |
用同一个问题对比多个 Provider |
qllm_pipeline |
串联多个模型步骤完成任务 |
qllm_heavy_discuss |
多视角、多模型讨论,可由模型或 Codex 主持 |
qllm_heavy_render |
把 Codex 主持后的讨论渲染成 Markdown / HTML 报告 |
qllm_claude_code_* |
通过 MCP 安全调用本机 Claude Code CLI |
推荐工作流
用户问题
|
+-- qllm_route_task 选择模型
|
+-- qllm_chat / qllm_compare / qllm_pipeline
|
+-- 复杂议题: qllm_heavy_discuss
|
+-- 多模型独立给观点
+-- Codex 或指定模型主持
+-- qllm_heavy_render 输出 Markdown / HTML
这套设计的核心不是“多叫几个模型凑热闹”,而是让不同模型承担不同角色:快速模型做初稿,强推理模型做审查,写作模型做表达,Codex 作为当前工作区里的主持人整合上下文和行动方案。
快速开始
1. 准备环境
要求:
- macOS 或 Linux
- Python 3.10+
- 一个支持 MCP 的客户端,例如 Codex、Claude Desktop、Claude Code、Cursor 等
- 至少一个 LLM Provider 的 API Key
克隆项目:
git clone https://github.com/joeseesun/qiaomu-llm-mcp.git
cd qiaomu-llm-mcp
如果你还没有 GitHub 版本,也可以先在本地目录安装:
cd /path/to/qiaomu-llm-mcp
2. 安装 Python 依赖
python3 -m venv .venv
.venv/bin/python -m pip install -U pip
.venv/bin/python -m pip install -e .
确认可执行文件存在:
test -x .venv/bin/qiaomu-llm-mcp && echo "qiaomu-llm-mcp installed"
.venv/bin/python -c "import qiaomu_llm_mcp; print(qiaomu_llm_mcp.__version__)"
MCP server 通常通过 stdio 被客户端启动。直接运行时它会等待 MCP 客户端消息,这是正常现象。
3. 创建 Provider 注册表
复制示例配置:
mkdir -p ~/.config/qiaomu-llm
cp examples/registry.example.json ~/.config/qiaomu-llm/registry.json
编辑 ~/.config/qiaomu-llm/registry.json,保留你要用的 Provider,删除不用的 Provider。
示例中的 Z.ai Coding Plan 使用专用 Coding endpoint:
{
"base_url": "https://api.z.ai/api/coding/paas/v4",
"default_model": "glm-5.2"
}
注意:Z.ai Coding Plan 要使用 https://api.z.ai/api/coding/paas/v4,不要误用通用 endpoint https://api.z.ai/api/paas/v4。
4. 把 API Key 放进 Keychain
推荐使用 Keychain,不要把明文 Key 写入配置文件。
Z.ai:
security add-generic-password -U \
-s qiaomu-llm \
-a zai-glm \
-w "$ZAI_API_KEY"
DeepSeek:
security add-generic-password -U \
-s qiaomu-llm \
-a deepseek \
-w "$DEEPSEEK_API_KEY"
Anthropic-compatible Provider:
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"qiaomu-llm": {
"command": "/absolute/path/to/qiaomu-llm-mcp/.venv/bin/qiaomu-llm-mcp"
}
}
}