Gemini MCP 工具

📚 查看完整文档 - 搜索我！示例、常见问题解答、故障排除、最佳实践

这是一个简单的模型上下文协议（MCP）服务器，允许 AI 助手与 Gemini CLI 交互。它使 AI 能够利用 Gemini 海量的上下文窗口进行大规模分析，尤其是在处理大型文件和代码库时，可以使用 @ 语法来指定方向。

• 通过 Claude 向 Gemini 提出自然问题，或在三人小组中一起头脑风暴新想法！

简要说明： +

目标：直接在 Claude Code 中使用 Gemini 强大的分析能力，以节省 token 并分析大型文件。

先决条件

在使用此工具之前，请确保您已安装以下内容：

1. Node.js（v16.0.0 或更高版本）
2. Google Gemini CLI 已安装并配置好

一行设置

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

验证安装

在 Claude Code 中输入 /mcp，以验证 gemini-cli MCP 是否已激活。

---

替代方案：从 Claude Desktop 导入

如果您已经在 Claude Desktop 中进行了配置：

1. 将以下内容添加到您的 Claude Desktop 配置中：

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

2. 导入到 Claude Code：

claude mcp add-from-claude-desktop

配置

将 MCP 服务器注册到您的 MCP 客户端：

对于 NPX 使用（推荐）

将以下配置添加到您的 Claude Desktop 配置文件中：

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

对于全局安装

如果您已全局安装，则使用以下配置代替：

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

配置文件位置：

• 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

更新配置后，请重新启动终端会话。

示例工作流程

• 自然语言：“使用 Gemini 解释 index.html”，“用 Gemini 理解这个庞大的项目”，“让 Gemini 搜索最新新闻”
• Claude Code：输入 /gemini-cli，命令将出现在 Claude Code 的界面中。

使用示例

带文件引用（使用 @ 语法）

• “让 Gemini 分析 @src/main.js 并解释其作用”
• “使用 Gemini 概括 @ 当前目录”
• “分析 @package.json 并告诉我依赖关系”

一般问题（不带文件）

• “让 Gemini 搜索最新的科技新闻”
• “用 Gemini 解释 div 居中”
• “让 Gemini 介绍与 @file_im_confused_about 相关的 React 开发最佳实践”

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

沙盒模式允许您在隔离环境中安全地测试代码更改、运行脚本或执行潜在风险操作。

• “使用 Gemini 沙盒创建并运行一个处理数据的 Python script”
• “让 Gemini 安全地测试 @script.py 并解释其作用”
• “使用 Gemini 沙盒安装 numpy 并创建数据可视化”
• “安全地测试这段代码：创建一个向 API 发送 HTTP 请求的脚本”

工具（供 AI 使用）

这些工具专为 AI 助手设计。

• ask-gemini：向 Google Gemini 询问其观点。可用于一般性问题或对文件的复杂分析。
  • prompt（必填）：分析请求。使用 @ 语法包含文件或目录引用（例如 @src/main.js 解释这段代码），或提出一般性问题（例如 请使用网络搜索查找最新新闻故事）。
  • model（可选）：要使用的 Gemini 模型。默认为 gemini-2.5-pro。
  • sandbox（可选）：设置为 true 以在沙盒模式下运行，从而安全执行代码。
• sandbox-test：在 Gemini 的沙盒环境中安全地执行代码或命令。始终在沙盒模式下运行。
  • prompt（必填）：代码测试请求（例如 创建并运行一个处理数据的 Python 脚本 或 @script.py 安全地运行此脚本）。
  • model（可选）：要使用的 Gemini 模型。
• Ping：一个简单的测试工具，用于回显消息。
• Help：显示 Gemini CLI 的帮助文本。

斜杠命令（供用户使用）

您可以在 Claude Code 的界面中直接使用这些命令（与其他客户端的兼容性尚未测试）。

• /analyze：使用 Gemini 分析文件或目录，或提出一般性问题。
  • prompt（必填）：分析提示。使用 @ 语法包含文件（例如 /analyze prompt:@src/ 概括此目录）或提出一般性问题（例如 /analyze prompt:请使用网络搜索查找最新新闻故事）。
• /sandbox：在 Gemini 的沙盒环境中安全地测试代码或脚本。
  • prompt（必填）：代码测试请求（例如 /sandbox prompt:创建并运行一个处理 CSV 数据的 Python 脚本 或 /sandbox prompt:@script.py 安全地测试此脚本）。
• /help：显示 Gemini CLI 的帮助信息。
• /ping：测试与服务器的连接。
  • message（可选）：要回显的消息。

贡献

欢迎贡献！请参阅我们的 贡献指南，了解如何提交拉取请求、报告问题以及参与项目。

许可证

本项目采用 MIT 许可证授权。详细信息请参阅 LICENSE 文件。

免责声明：这是一款非官方的第三方工具，与 Google 无关联、未获其认可或赞助。

Gemini MCP Tool 快速上手指南

Gemini MCP Tool 是一个简单的模型上下文协议（MCP）服务器，旨在让 AI 助手（如 Claude Code）能够直接调用 Google Gemini CLI。利用 Gemini 强大的长上下文窗口能力，它可以高效分析大型文件、代码库或执行复杂任务。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

1. Node.js: 版本需为 v16.0.0 或更高。
   • 国内用户推荐使用 cnpm 或配置 npm 镜像源加速安装。
2. Google Gemini CLI: 必须已安装并完成配置（包含有效的 API Key）。
   • 安装命令：npm install -g @google/gemini-cli (需确保网络通畅或使用代理)。

安装步骤

方式一：一键安装（推荐）

如果您使用的是 Claude Code，可以直接运行以下命令将工具注册到 MCP 列表中：

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

方式二：手动配置 Claude Desktop

如果您需要手动编辑配置文件，请按以下步骤操作：

1. 找到配置文件 claude_desktop_config.json：

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

2. 在 mcpServers 字段中添加以下配置：

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

3. 保存文件并重启终端或 Claude 应用。

验证安装

在 Claude Code 界面中输入 /mcp，确认 gemini-cli 出现在活跃服务器列表中。

基本使用

安装完成后，您可以在对话中直接使用自然语言指令，或通过斜杠命令调用 Gemini 的能力。

1. 自然语言交互

直接在对话框中输入指令，利用 @ 符号引用文件或目录：

• 分析特定文件：

  ask gemini to analyze @src/main.js and explain what it does
  

• 总结当前目录：

  use gemini to summarize @. the current directory
  

• 通用问题查询：

  ask gemini to search for the latest tech news
  

2. 使用斜杠命令

在 Claude Code 界面中，可以使用以下专用命令：

• 分析文件 (/analyze)：

  /analyze prompt:@package.json tell me about dependencies
  

• 沙箱测试 (/sandbox)： 安全地运行代码或脚本（隔离环境）：

  /sandbox prompt:Create and run a Python script that processes data
  

  或测试现有文件：

  /sandbox prompt:@script.py Test this script safely
  

3. 高级功能：沙箱模式

通过指定 sandbox 参数或使用 /sandbox 命令，您可以在安全隔离的环境中让 Gemini 执行代码、安装依赖或进行网络请求，无需担心本地环境受损。

注意：本工具为第三方开源项目，非 Google 官方出品。使用时请妥善保管您的 API Key。