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 没有关联、未得到其认可或赞助。