Gemini CLI Orchestrator MCP

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服务器”或工具不可用：

1. 检查文件名/配置冲突 （最常见的问题）

- 按照上面的“处理以前的安装”一节进行操作 - 文件已从重命名 gemini-orchestrator.mjs 向 gemini-collaboration-guide.mjs

1. 清洁设置过程:

   # 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

1. 验证文件是否存在:

   ls -la /path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs

1. 测试服务器是否可以启动:

   node /path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs --help

1. 重新启动Claude代码 在任何配置更改后完全

1. 验证成功:

   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 @**/*.js

v2.0中的新增功能

🎉 完成建筑重新设计 -从复杂的包装器到简单的编排器\ 🎉 消除了身份验证的复杂性 -使用本机gemini CLI身份验证\ 🎉 真正的元提示方法 -引导智能而不是取代它\ 🎉 顺序思维工作流程 -具有状态管理的多步分析\ 🎉 简化设置 -没有复杂的配置或环境变量

哲学

该工具体现了元提示原则： 系统复杂性下的信任代理智能.

它提供了简单的工具，指导你系统地思考复杂的问题，而不是试图在分析中变得聪明。结果是更周到的分析和更好的见解。

非常适合通过智能、结构化的工作流程利用Gemini的大型上下文窗口。