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的巨大上下文窗口。