多语言模型管理服务器

一个允许在Claude Code中使用GPT和Gemini作为工具的MCP服务器,支持OAuth登录、CLI优先认证和多模型集成。

  • by JONGSEO-YOON
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 JONGSEO-YOON/multi-llm-mcp

使用说明

多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 도구 사용

认证方式

优先级

  1. CLI登录 (推荐)-无需API密钥
  2. 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-mini
  • o1, o1-mini

GPT(通过API)

  • gpt-4o (默认)
  • gpt-4o-mini
  • gpt-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要求“确认身份验证状态”

许可证

麻省理工学院