Gemini Cli Orchestrator

🚀 Gemini CLI Orchestrator v2.0 - 顺序思维MCP

Gemini CLI Orchestrator v2.0是一个以元提示为先的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

步骤5：尝试首次分析（使用Claude Code CLI）

# 从规划一个简单的分析开始
gemini_plan_analysis goal="Understand this project's main architecture"

# 然后为第一步设计一个具体的提示
gemini_craft_prompt step_description="Analyze package.json and README for project overview" context="Starting fresh analysis"

完成以上步骤即可！身份验证由gemini CLI自动处理。

✨ 主要特性

• 简化身份验证：使用现有的gemini CLI设置。
• 真正的元提示：引导用户发挥智能，而非取而代之。
• 多步骤分析：将复杂问题分解为可管理的步骤。
• 灵活的工作流程：可根据发现调整分析方法。
• 直接集成Gemini：无包装复杂性或身份验证开销。

📦 安装指南

步骤1：安装Gemini CLI

npm install -g @google/gemini-cli

步骤2：进行身份验证（一次性设置）

gemini auth login

步骤3：安装本工具

npm install

💻 使用示例

基础用法

本工具提供了四个简单的工具来引导用户进行系统分析：

🎯 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. 开始："Comprehensive security audit of web application"
2. 步骤1："Identify all authentication mechanisms" → @src/auth/ @middleware/
3. 步骤2："Analyze API endpoint security" → @src/api/ @src/routes/
4. 步骤3："Review data validation and sanitization" → @src/validation/ @src/models/
5. 步骤4："Check for common vulnerabilities (OWASP)" → @src/
6. 结束："Generate prioritized security report with remediation steps"

性能分析工作流示例

1. 开始："Identify performance bottlenecks in React application"
2. 步骤1："Analyze component rendering patterns" → @src/components/
3. 步骤2："Review state management efficiency" → @src/store/ @src/hooks/
4. 步骤3："Check for unnecessary re-renders" → @src/components/
5. 步骤4："Analyze bundle size and imports" → @package.json @webpack.config.js
6. 结束："Provide performance optimization recommendations"

架构审查工作流示例

1. 开始："Review microservices architecture for scalability"
2. 步骤1："Understand service boundaries" → @services/ @docker-compose.yml
3. 步骤2："Analyze inter-service communication" → @src/api/ @src/clients/
4. 步骤3："Review data flow and dependencies" → @src/models/ @src/schemas/
5. 步骤4："Evaluate error handling and resilience" → @src/middleware/ @src/utils/
6. 结束："Recommend architectural improvements for scalability"

📚 详细文档

• 工作原理 - 深入了解架构和元提示哲学。
• 贡献指南 - 如何为项目做出贡献。
• 行为准则 - 社区标准和期望。

🤝 贡献

我们欢迎贡献！请参阅我们的贡献指南和行为准则，了解如何参与。

MCP配置

⚠️ 重要提示

如果你之前安装过此MCP服务器（特别是如果你使用过gemini-orchestrator.mjs），可能会有缓存配置。为了清晰起见，文件名已更改为gemini-collaboration-guide.mjs。如果你遇到设置问题，请参阅下面的“处理先前安装”部分。

Claude Code CLI（推荐）

配置MCP服务器最简单、最可靠的方法：

# 使用Claude Code的内置命令添加服务器
claude mcp add gemini-collaboration-guide node /path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs

# 验证是否已添加
claude mcp list

# 在Claude Code中测试是否正常工作
/mcp

重要事项：

• 使用gemini-collaboration-guide.mjs文件的完整绝对路径。
• 服务器名称必须为gemini-collaboration-guide。
• 添加服务器后重启Claude Code。

处理先前安装 / 文件名更改

如果你之前配置过此MCP服务器或遇到“Status: ✘ failed”等问题，请按照以下步骤操作：

# 1. 删除任何旧配置
claude mcp remove gemini-cli-orchestrator    # 旧名称
claude mcp remove gemini-orchestrator        # 另一个旧名称  
claude mcp remove gemini-collaboration-guide # 清理

# 2. 验证清理状态
claude mcp list

# 3. 使用正确的文件名添加（使用你实际的路径）
claude mcp add gemini-collaboration-guide node /Users/dannynguyen/gemini-cli-orchestrator/gemini-collaboration-guide.mjs

# 4. 完全重启Claude Code

# 5. 测试是否正常工作
/mcp

手动配置（替代方法）

如果你更喜欢手动JSON配置：

Claude Desktop - 配置文件：~/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"]
    }
  }
}

Cursor 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。
2. 全新设置过程：

# 删除所有旧配置
claude mcp remove gemini-cli-orchestrator
claude mcp remove gemini-orchestrator  
claude mcp remove gemini-collaboration-guide

# 使用正确的文件名添加
claude mcp add gemini-collaboration-guide node /absolute/path/to/gemini-collaboration-guide.mjs

3. 验证文件是否存在：

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

4. 测试服务器是否可以启动：

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

5. 进行任何配置更改后完全重启Claude Code
6. 验证是否成功：

claude mcp list    # 应显示：gemini-collaboration-guide
/mcp              # 应显示四个工具

常见错误：

• Status: ✘ failed → 通常是文件名错误（使用gemini-collaboration-guide.mjs）。
• 文件不存在 → 检查绝对路径是否正确。
• 工具未显示 → 配置后重启Claude Code。

🔧 技术细节

文件模式示例

使用glob模式将分析集中在相关文件上：

# 特定语言的模式
@**/*.js @**/*.ts          # JavaScript/TypeScript
@**/*.py                   # Python
@**/*.go                   # Go
@**/*.rs                   # Rust
@**/*.java                 # Java

# 特定框架的模式
@src/components/ @src/hooks/     # React
@src/models/ @src/views/         # MVC框架
@src/services/ @src/controllers/ # 服务层

# 文件类型模式
@package.json @*.config.js       # 配置
@**/*.test.js @**/*.spec.js      # 测试
@README.md @docs/                # 文档

要求

• Node.js 18+
• 已安装并认证Google Gemini CLI
• 对glob模式有基本了解

故障排除

“找不到命令：gemini”

npm install -g @google/gemini-cli

“身份验证失败”

gemini auth login

“未找到文件”

# 检查你的文件模式是否与项目结构匹配
# 使用更广泛的模式，如 @src/ 或 @**/*.js

2.0版本新增功能

• 🎉 全面的架构重新设计 - 从复杂的包装器转变为简单的编排器。
• 🎉 消除身份验证复杂性 - 使用原生gemini CLI身份验证。
• 🎉 真正的元提示方法 - 引导智能而非取代它。
• 🎉 顺序思维工作流 - 带有状态管理的多步骤分析。
• 🎉 简化设置 - 无需复杂的配置或环境变量。

哲学

本工具体现了元提示原则：信任代理智能而非系统复杂性。

它不是试图让分析变得“聪明”，而是提供简单的工具，引导用户系统地思考复杂问题。结果是更周全的分析和更好的见解。非常适合通过智能、结构化的工作流利用Gemini的巨大上下文窗口。