【技术文档摘要】

Gemini MCP 工具

<div align="center">

</div>

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

这是一个简单的模型上下文协议（MCP）服务器，允许AI助手与Gemini CLI进行交互。它使AI能够利用Gemini的强大分析能力来处理大型文件和代码库，特别是使用@语法进行方向性分析。

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

<a href="https://glama.ai/mcp/servers/@jamubc/gemini-mcp-tool"> <img width="380" height="200" src="https://gips2.baidu.com/it/u=1134795994,4149692325&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Gemini 工具 MCP 服务器" /> </a>

简言之： +

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

预备条件

在使用此工具之前，请确保您已具备以下条件：

1. Node.js (版本16.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有关React开发的最佳实践，特别是关于@file_im_confused_about

使用Gemini CLI的沙箱模式（-s）

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

• 使用Gemini沙箱创建并运行一个处理数据的Python脚本
• 让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（必需）：代码测试请求（例如，创建并运行一个处理CSV数据的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的认可、赞助或支持。