
joeseesun/qiaomu-llm-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
株式会社、本地和和 HeavySkill 一一成 MCP MC | 멀티 프로바이더 LLM 라우팅, 비밀, 헤스킬 토론을 위한 로컬 MCP 게이트웨이.
개요
把 LLM 제공 업체、API 키、星和一成一一本地 MCP 一。 많은 LLM 제공 업체, API 키, 라우팅 규칙 및 멀티 모델 토론을 하나의 도구 표면으로 전환하는 로컬 MCP 게이트웨이. De用 Z.ai 코딩 플랜、DeepSeek、OpenAI-compatible API、Anthropic-compatible API、Claude Code CLI ☸ 。 - 多 API 키 He、本鶏 Codex ☸里。 - 一 Codex / Claude / 里 MCP 里用一一一成:多、多多、He、水鶏、HeavySkill 式多多。 本本:Provider ~/.config/qiaomu-llm/registry.json,在放題 macOS 키체인,MCP 서버 “密钥是否存在”,,会 Key明 키。 上的里“多”,上:行,,理前,前,Codex 前前前区里的人人人合上下文行和和方程式。 - macOS는 리눅스 - Python 3.10+ - 一 MC MCP 的一, MC Codex、Claude Desktop、Claude Code、Cursor ☸ - 一一一 LLM Provider 的 API Key MC 过 过 过 MC MC MC,行。 ~/.config/qiaomu-llm/registry.json,,用的 Provider,,用的 Provider。 ai中的 Z.ai Coding Plan 使用 Co end end end end end end ai
개요(AI 번역)
内多多 LLM 공급자、API 키、星和一成一一本地 MCP 一。 많은 LLM 제공 업체, API 키, 라우팅 규칙 및 멀티 모델 토론을 하나의 도구 표면으로 전환하는 로컬 MCP 게이트웨이.
中文 | 한국어
适:
- ai用 Z.ai 코딩 플랜、DeepSeek、OpenAI 호환 API、Anthropic 호환 API、Claude Code CLI ☸ 。
- 脚 API 키 、脚 里 里里。
- 里 里 里 里 里 里 里 里 一 一 多 He He He He He。
- 一的一,一一一 제공자。
本本:Provider ~/.config/qiaomu-llm/registry.json],放放題 macOS Keychain,MCP 서버 “””,会返回明文 Key。
₢ 킹
安,MCP 安会::
인포메이션
인포메이션
| qllm_list_providers | 本地鶏的 Provider, 스티븐安安 |
| [T2] | 공급자 的 |
| qllm_list_models | 本地配置或远程 /models 的世界 |
| 【T5】 | 網頁標題花 토큰, 공급자 / 모델 |
| qllm_chat | 후쿠오카 현
| [T7] | 다케토 一一 多
| 【T8】 | 成 |
| 【T9】 | 多多、多多、多、多、多
| [T10] | 把成 //HTML |
| qllm_claude_code_* | MCP 安过用本線 코드 CLI |
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
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"
}
}
}