使用说明
多LLM MCP服务器
Claude Code中 GPT哇 双子座允许作为工具使用的MCP服务器。
一键安装
curl -fsSL https://raw.githubusercontent.com/jongseo-yoon/multi-llm-mcp/main/install.sh | bash
仅此一个命令即可自动完成从安装到Claude Code设置!
特点
- OAuth登录支持 -使用ChatGPT/Google帐户登录,无需API密钥
- CLI优先 -通过Codex CLI、Gemini CLI进行身份验证
- API密钥回退 -如果CLI无法登录,则可以使用API密钥
- 轻松应用于其他服务器 -Git克隆后,只需运行安装脚本即可完成设置
- Claude Context节省 -/init时MCP服务器导航+分析,Claude只接收结果
交付工具
代理(Sub Agents)
| 工具 | 说明 |
|---|---|
oracle |
高级推理代理(GPT-5.2)-体系结构设计、算法优化 |
review_implementation |
实施审查代理(GPT-5.2)-验证是否满足要求 |
multi_init |
项目初始化-compact=true(默认)时~100令牌,false时GPT+Gemini全面分析 |
explore_code |
代码库导航(Gemini)-代替Glob/Read/Grep,节省Claude context |
frontend_designer |
编写UI/UX代码(Gemini 3)-React、Vue、Tailwind等 |
document_writer |
合成文档(Gemini 3)-README,API文档,注释 |
multimodal_look |
图像分析(Gemini 3)-在屏幕截图中生成代码,发现错误 |
基本工具
| 工具 | 说明 |
|---|---|
ask_gpt |
向GPT提问(Codex CLI或API) |
ask_gemini |
向Gemini提问(Gemini CLI或API) |
compare_models |
向两个模型发送相同的问题并进行比较 |
check_status |
验证状态检查 |
login_guide |
登录方法指南 |
历史管理
| 工具 | 说明 |
|---|---|
set_project_root |
设置项目根目录(保存历史记录的位置) |
get_history |
查看最近的工作历史记录 |
compact_history |
压缩旧的历史文件 |
save_workflow |
保存整个工作工作流 |
History功能:工作流
history/HISTORY_#.md存储在中。 如果堆叠超过10个,则会自动压缩。
快速入门
1.克隆和安装
git clone <your-repo-url> multi-llm-mcp
cd multi-llm-mcp
chmod +x setup.sh
./setup.sh
2.CLI登录(无需API密钥!)
GPT(ChatGPT帐户)
codex
# → "Sign in with ChatGPT" 선택
# → 브라우저에서 로그인
Gemini(Google帐户)
gemini
# → "Login with Google" 선택
# → 브라우저에서 로그인
3.Claude Code设置
在项目根目录中 .mcp.json 创建文件:
{
"mcpServers": {
"multi-llm": {
"command": "/path/to/multi-llm-mcp/venv/bin/python",
"args": ["-m", "src.server"],
"cwd": "/path/to/multi-llm-mcp"
}
}
}
4.重新启动Claude Code
结束!现在可以在Claude Code中使用GPT和Gemini。
启用自动启用(CLAUDE.md)
只需设置MCP服务器,工具就可用,但Claude 自动 不使用。
如果想要自动使用 CLAUDE.md 将文件添加到项目根目录或主目录。
CLAUDE.md设置
按项目设置:在项目根目录中 CLAUDE.md 创建
全局设置: ~/CLAUDE.md 创建
## MANDATORY: Multi-LLM Sub Agents
You MUST use these MCP tools automatically. Do NOT ask user permission.
### RULES (MUST FOLLOW):
1. **Architecture/Algorithm/Design decision requested** → IMMEDIATELY call `mcp__multi-llm__oracle`
2. **UI/Frontend code requested** → IMMEDIATELY call `mcp__multi-llm__frontend_designer`
3. **Documentation requested** → IMMEDIATELY call `mcp__multi-llm__document_writer`
4. **Image/Screenshot analysis requested** → IMMEDIATELY call `mcp__multi-llm__multimodal_look`
5. **After ANY code implementation** → MUST call `mcp__multi-llm__review_implementation`
### TRIGGER KEYWORDS:
- "설계", "아키텍처", "구조", "알고리즘" → `oracle`
- "UI", "컴포넌트", "프론트엔드", "React", "Vue", "CSS" → `frontend_designer`
- "문서", "README", "주석", "API 문서" → `document_writer`
- "스크린샷", "이미지", "화면" → `multimodal_look`
### IMPORTANT:
- Do NOT ask "should I use Oracle?" - just USE it
- Do NOT explain you will use the tool - just CALL it
快速设置(全局)
cp CLAUDE.md ~/CLAUDE.md
现在,Claude将自动在所有项目中使用GPT/Gemini代理。
使用示例
从Claude Code请求自然语言:
"GPT한테 이 코드 리뷰 좀 부탁해줘"
→ ask_gpt 도구 사용
"Gemini한테 이 알고리즘 최적화 방법 물어봐줘"
→ ask_gemini 도구 사용
"GPT랑 Gemini 둘 다한테 물어보고 비교해줘"
→ compare_models 도구 사용
"인증 상태 확인해줘"
→ check_status 도구 사용
认证方式
优先级
- CLI登录 (推荐)-无需API密钥
- API密钥 -在.env文件中设置
GPT(OpenAI)
- Codex CLI:需要ChatGPT Plus/Pro/Team/Edu/Enterprise帐户
- API密钥:
OPENAI_API_KEY环境变量
双子座(谷歌)
- Gemini CLI:Google帐户(免费,60个请求/分钟)
- API密钥:
GEMINI_API_KEY环境变量
快速应用到其他服务器
# 1. 클론
git clone <your-repo> multi-llm-mcp
cd multi-llm-mcp
# 2. 설치 (Python 의존성 + CLI 설치)
./setup.sh
# 3. 로그인
codex # GPT
gemini # Gemini
# 4. Claude Code 설정에 추가 (위의 JSON 참고)
# 5. Claude Code 재시작
可选:设置API密钥
要使用API密钥而不是CLI登录,请:
cp .env.example .env
# .env 파일 편집하여 API 키 입력
OPENAI_API_KEY=sk-...
GEMINI_API_KEY=...
支持的型号
GPT(通过Codex CLI)
o4-mini(默认)o3-minio1,o1-mini
GPT(通过API)
gpt-4o(默认)gpt-4o-minigpt-4-turbo
Gemini(通过CLI)
gemini-3(默认)- 图像分析支持(
@./path/to/image.png格式)
Gemini(通过API)
gemini-1.5-flash(默认值,较快)gemini-1.5-pro(高品质)gemini-2.0-flash-exp
图像分析(Multimodal)
Gemini CLI支持映像。无需API密钥即可使用。
# Gemini CLI로 이미지 분석
"이 스크린샷 분석해줘" + 이미지 경로 전달
→ multimodal_look 도구 사용
故障排除
CLI登录错误
Codex CLI에 로그인이 필요합니다.
→在终端 codex 运行后登录
CLI安装错误
# Codex CLI 수동 설치
npm install -g @openai/codex
# Gemini CLI 수동 설치
npm install -g @google/gemini-cli
状态确认
Claude Code要求“确认身份验证状态”
许可证
麻省理工学院