Gemini MCP Tool Patched

🚀 Gemini MCP Tool (Patched)

這是一個經過修補以兼容 Windows 的工具，它基於 gemini-mcp-tool 的 v1.1.2 版本。該 MCP 服務器支持使用 Gemini API 密鑰或 OAuth 憑證（允許通過 Gemini CLI 使用 Google AI Pro）。

工具亮點

• 這是一個簡單的模型上下文協議（MCP）服務器，可讓 AI 助手與 Gemini CLI 進行交互。
• 藉助 Gemini 強大的大令牌窗口功能，AI 能夠對大型文件和代碼庫進行深入分析，尤其是通過 @ 語法指定分析目標。
• 可以向 Gemini 提出自然語言問題，還能與 Claude 協作，或在多人場景下頭腦風暴新想法。

相關文檔

• 📚 查看補丁文檔
• 📚 查看完整文檔 - 包含搜索功能、使用示例、常見問題解答、故障排除和最佳實踐

🚀 快速開始

目標

在 Claude Code 中直接使用 Gemini 的強大分析功能，節省令牌並分析大型文件。

前提條件

在使用此工具之前，請確保具備以下條件：

1. Node.js（版本 16.0.0 或更高）
2. 已安裝並配置 Google Gemini CLI

一鍵設置

claude mcp add gemini-cli -- npx -y gemini-mcp-tool-patched

驗證安裝

在 Claude Code 中輸入 /mcp，以驗證 gemini-cli MCP 是否激活。

替代方法：從 Claude Desktop 導入

如果已在 Claude Desktop 中進行了配置，可以按照以下步驟操作：

1. 在 Claude Desktop 配置文件中添加以下內容：

"gemini-cli": {
  "command": "npx",
  "args": ["-y", "gemini-mcp-tool-patched"]
}

2. 導入到 Claude Code：

claude mcp add-from-claude-desktop

📦 安裝指南

配置 MCP 服務器

將 MCP 服務器註冊到 MCP 客戶端：

使用 NPX（推薦）

在 Claude Desktop 配置文件中添加以下配置：

{
  "mcpServers": {
    "gemini-cli": {
      "command": "npx",
      "args": ["-y", "gemini-mcp-tool-patched"]
    }
  }
}

全局安裝

如果已全局安裝該工具，請使用以下配置：

{
  "mcpServers": {
    "gemini-cli": {
      "command": "gemini-mcp-patched"
    }
  }
}

配置文件位置

• Claude Desktop：
  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%\Claude\claude_desktop_config.json
  • Linux：~/.config/claude/claude_desktop_config.json

更新配置後，請重啟終端會話。

💻 使用示例

帶有文件引用（使用 @ 語法）

• ask gemini to analyze @src/main.js and explain what it does
• use gemini to summarize @. the current directory
• analyze @package.json and tell me about dependencies

一般問題（不涉及文件）

• ask gemini to search for the latest tech news
• use gemini to explain div centering
• ask gemini about best practices for React development related to @file_im_confused_about

使用 Gemini CLI 的沙盒模式 (-s)

沙盒模式允許在隔離環境中安全地測試代碼更改、運行腳本或執行潛在風險操作。

• use gemini sandbox to create and run a Python script that processes data
• ask gemini to safely test @script.py and explain what it does
• use gemini sandbox to install numpy and create a data visualization
• test this code safely: Create a script that makes HTTP requests to an API

工具（供 AI 使用）

這些工具專為 AI 助手設計：

• ask-gemini：向 Google Gemini 詢問觀點，可用於一般問題或文件的複雜分析。
  • prompt（必需）：分析請求，使用 @ 語法包含文件或目錄引用（例如 @src/main.js explain this code）或提出一般問題（例如 Please use a web search to find the latest news stories）。
  • model（可選）：要使用的 Gemini 模型，默認為 gemini-2.5-pro。
  • sandbox（可選）：設置為 true 以在沙盒模式下運行，確保代碼安全執行。
• sandbox-test：在 Gemini 的沙盒環境中安全執行代碼或命令，始終在沙盒模式下運行。
  • prompt（必需）：代碼測試請求（例如 Create and run a Python script that... 或 @script.py Run this safely）。
  • model（可選）：要使用的 Gemini 模型。
• Ping：一個簡單的測試工具，會回顯消息。
• Help：顯示 Gemini CLI 的幫助文本。

斜槓命令（供用戶使用）

可以直接在 Claude Code 的界面中使用這些命令（與其他客戶端的兼容性尚未測試）：

• /analyze：使用 Gemini 分析文件或目錄，或提出一般問題。
  • prompt（必需）：分析提示，使用 @ 語法包含文件（例如 /analyze prompt:@src/ summarize this directory）或提出一般問題（例如 /analyze prompt:Please use a web search to find the latest news stories）。
• /sandbox：在 Gemini 的沙盒環境中安全測試代碼或腳本。
  • prompt（必需）：代碼測試請求（例如 /sandbox prompt:Create and run a Python script that processes CSV data 或 /sandbox prompt:@script.py Test this script safely）。
• /help：顯示 Gemini CLI 的幫助信息。
• /ping：測試與服務器的連接。
  • message（可選）：要回顯的消息。

🤝 貢獻

歡迎貢獻代碼！請參閱 貢獻指南 瞭解如何提交拉取請求、報告問題以及為項目做出貢獻的詳細信息。

📄 許可證

本項目採用 MIT 許可證。有關詳細信息，請參閱 LICENSE 文件。

免責聲明：這是一個非官方的第三方工具，與 Google 沒有關聯、未得到其認可或贊助。