Gemini CLI Orchestrator v2.0-顺序思维MCP
一个元模拟的第一个MCP服务器，使用谷歌的Gemini AI引导AI代理进行智能、多步骤的代码库分析。
🧠 核心理念
不要在系统中建立智能。构建从代理那里获取情报的提示。
这个工具不会包装或取代你的思维——它引导你通过结构化的工作流程更系统地思考复杂的代码库分析。
🚀 快速开始
步骤1：安装Gemini CLI
npm install -g @google/gemini-cli步骤2：身份验证（一次性设置）
gemini auth login步骤3：安装此工具
npm install步骤4：测试它是否有效
node gemini-collaboration-guide.mjs第五步：尝试第一次分析 （使用克劳德代码CLI）
# Start with planning a simple analysis
gemini_plan_analysis goal="Understand this project's main architecture"
# Then craft a specific prompt for the first step
gemini_craft_prompt step_description="Analyze package.json and README for project overview" context="Starting fresh analysis"就是这样！身份验证由gemini CLI自动处理。
运作原理
这个工具提供了四个简单的工具来指导你进行系统分析，而不是试图对你的分析“聪明”：
🎯 gemini_plan_analysis(goal)
将复杂的分析目标分解为一个循序渐进的计划。具体说明你想了解什么以及为什么。
例子：
gemini_plan_analysis goal="Audit authentication system for security vulnerabilities"🔍 gemini_craft_prompt(step_description, context)
通过为每个分析步骤建议有效的命令和上下文，帮助您为Gemini编写更好的提示。
例子：
gemini_craft_prompt step_description="Analyze JWT token handling" context="Found 3 auth endpoints, focusing on token security"🔄 gemini_iterate_analysis(current_understanding, iteration_goal)
使用观察-思考-行动循环来指导迭代分析，以解决动态问题。
例子：
gemini_iterate_analysis current_understanding="Found potential SQL injection in login" iteration_goal="Investigate if other endpoints have similar issues"📊 gemini_synthesize_findings(steps_summary, synthesis_goal)
将多个分析步骤的见解结合起来，形成全面的理解。
例子：
gemini_synthesize_findings steps_summary="Analyzed auth system, found 2 vulnerabilities, tested 5 endpoints" synthesis_goal="Create security audit report with prioritized fixes"工作流示例
以下是如何使用编排器进行安全审计：
# 1. Plan the overall analysis
gemini_plan_analysis goal="Analyze authentication system for security vulnerabilities"
# → Outputs: 5-stage analysis plan with specific steps
# 2. Execute each planned step
gemini_craft_prompt step_description="Identify authentication mechanisms" context="Security audit of auth system"
# → Outputs: Optimized gemini command to analyze auth files
# → You run: cat src/auth/**/* | gemini -m gemini-2.5-flash -p "..."
# 3. Dive deeper if needed
gemini_iterate_analysis current_understanding="Found JWT + session auth" iteration_goal="Check for common auth vulnerabilities"
# → Outputs: ReAct loop guidance for systematic vulnerability testing
# 4. Synthesize final report
gemini_synthesize_findings steps_summary="Analyzed 3 auth mechanisms, found 2 issues" synthesis_goal="Security audit report with fixes"
# → Outputs: Comprehensive synthesis strategy for final report🎯 关键利益
✅ 简化身份验证 -使用现有的gemini CLI设置\ ✅ 真正的 Metaprompting -引导你的智慧，而不是取代它\ ✅ 多步分析 -将复杂问题分解为可管理的步骤\ ✅ 灵活的工作流程 -根据你的发现调整你的方法\ ✅ 直接Gemini集成 -无包装复杂性或身份验证开销
📚 文档
🤝 贡献
我们欢迎捐款！请查看我们的 贡献指南 和 行为准则 了解如何参与的详细信息。
MCP配置
🚨 对现有用户的重要提示
如果您以前安装过此MCP服务器（特别是如果您使用 gemini-orchestrator.mjs)，您可能已经缓存了配置。文件名已重命名为 gemini-collaboration-guide.mjs 为了清楚起见。 请参阅下面的“处理以前的安装” 如果您遇到设置问题。
Claude Code命令行界面（推荐）
配置MCP服务器最简单、最可靠的方法：
# Add the server using Claude Code's built-in command
claude mcp add gemini-collaboration-guide node /path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs
# Verify it was added
claude mcp list
# Test it's working in Claude Code
/mcp重要提示：
- 使用完整的绝对路径
gemini-collaboration-guide.mjs文件 - 服务器名称必须精确
gemini-collaboration-guide - 添加服务器后重新启动Claude Code
处理以前的安装/文件名更改
如果您之前配置了此MCP服务器或遇到了“状态：✘ 失败”，请执行以下步骤：
# 1. Remove any old configurations
claude mcp remove gemini-cli-orchestrator # Old name
claude mcp remove gemini-orchestrator # Another old name
claude mcp remove gemini-collaboration-guide # Clean slate
# 2. Verify clean state
claude mcp list
# 3. Add with correct filename (use YOUR actual path)
claude mcp add gemini-collaboration-guide node /Users/dannynguyen/gemini-cli-orchestrator/gemini-collaboration-guide.mjs
# 4. Restart Claude Code completely
# 5. Test it works
/mcp手动配置（备选）
如果您更喜欢手动JSON配置：
克劳德桌面 -配置文件： ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"gemini-collaboration-guide": {
"command": "node",
"args": ["/absolute/path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs"]
}
}
}光标IDE -配置文件： .cursor/mcp.json
{
"mcpServers": {
"gemini-collaboration-guide": {
"command": "node",
"args": ["/absolute/path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs"]
}
}
}Windsurf IDE -配置文件： windsurf_config.json
{
"mcpServers": {
"gemini-collaboration-guide": {
"command": "node",
"args": ["/absolute/path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs"],
"disabled": false,
"alwaysAllow": []
}
}
}故障排除
如果 /mcp 显示“未配置MCP服务器”或工具不可用：
- 检查文件名/配置冲突 （最常见的问题）
- 按照上面的“处理以前的安装”一节进行操作 - 文件已从重命名 gemini-orchestrator.mjs 向 gemini-collaboration-guide.mjs
- 清洁设置过程:
# Remove all old configurations
claude mcp remove gemini-cli-orchestrator
claude mcp remove gemini-orchestrator
claude mcp remove gemini-collaboration-guide
# Add with correct filename
claude mcp add gemini-collaboration-guide node /absolute/path/to/gemini-collaboration-guide.mjs- 验证文件是否存在:
ls -la /path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs- 测试服务器是否可以启动:
node /path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs --help- 重新启动Claude代码 在任何配置更改后完全
- 验证成功:
claude mcp list # Should show: gemini-collaboration-guide
/mcp # Should show the four tools常见错误：
Status: ✘ failed→ 通常错误的文件名（使用gemini-collaboration-guide.mjs)File does not exist→ 检查绝对路径是否正确- 工具未出现→ 配置后重新启动Claude代码
高级使用示例
安全审计工作流程
1. Start: "Comprehensive security audit of web application"
2. Step 1: "Identify all authentication mechanisms" → @src/auth/ @middleware/
3. Step 2: "Analyze API endpoint security" → @src/api/ @src/routes/
4. Step 3: "Review data validation and sanitization" → @src/validation/ @src/models/
5. Step 4: "Check for common vulnerabilities (OWASP)" → @src/
6. Conclude: "Generate prioritized security report with remediation steps"性能分析工作流程
1. Start: "Identify performance bottlenecks in React application"
2. Step 1: "Analyze component rendering patterns" → @src/components/
3. Step 2: "Review state management efficiency" → @src/store/ @src/hooks/
4. Step 3: "Check for unnecessary re-renders" → @src/components/
5. Step 4: "Analyze bundle size and imports" → @package.json @webpack.config.js
6. Conclude: "Provide performance optimization recommendations"架构审查工作流程
1. Start: "Review microservices architecture for scalability"
2. Step 1: "Understand service boundaries" → @services/ @docker-compose.yml
3. Step 2: "Analyze inter-service communication" → @src/api/ @src/clients/
4. Step 3: "Review data flow and dependencies" → @src/models/ @src/schemas/
5. Step 4: "Evaluate error handling and resilience" → @src/middleware/ @src/utils/
6. Conclude: "Recommend architectural improvements for scalability"文件模式示例
使用glob模式将分析重点放在相关文件上：
# Language-specific patterns
@**/*.js @**/*.ts # JavaScript/TypeScript
@**/*.py # Python
@**/*.go # Go
@**/*.rs # Rust
@**/*.java # Java
# Framework-specific patterns
@src/components/ @src/hooks/ # React
@src/models/ @src/views/ # MVC frameworks
@src/services/ @src/controllers/ # Service layer
# File type patterns
@package.json @*.config.js # Configuration
@**/*.test.js @**/*.spec.js # Tests
@README.md @docs/ # Documentation需求
- Node.js 18+
- 安装并验证了Google Gemini CLI
- 对地球模式的基本理解
故障排除
“找不到命令：gemini”
npm install -g @google/gemini-cli“身份验证失败”
gemini auth login“找不到文件”
# Check your file patterns match your project structure
# Use broader patterns like @src/ or @**/*.jsv2.0中的新增功能
🎉 完成建筑重新设计 -从复杂的包装器到简单的编排器\ 🎉 消除了身份验证的复杂性 -使用本机gemini CLI身份验证\ 🎉 真正的元提示方法 -引导智能而不是取代它\ 🎉 顺序思维工作流程 -具有状态管理的多步分析\ 🎉 简化设置 -没有复杂的配置或环境变量
哲学
该工具体现了元提示原则： 系统复杂性下的信任代理智能.
它提供了简单的工具，指导你系统地思考复杂的问题，而不是试图在分析中变得聪明。结果是更周到的分析和更好的见解。
非常适合通过智能、结构化的工作流程利用Gemini的大型上下文窗口。