Gemini MCP 工具

这是一个简单的模型上下文协议 (MCP) 服务器，允许 AI 助手与 Gemini CLI 交互。它使 AI 能够利用 Gemini 的大容量令牌窗口进行大规模分析，特别是在使用 @ 语法指示的大文件和代码库中。

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

TLDR: +

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

前提条件

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

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

一行设置

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

验证安装

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

替代方法：从 Claude Desktop 导入

如果你已经在 Claude Desktop 中配置好了：

1. 在你的 Claude Desktop 配置中添加以下内容：
   json
   "gemini-cli": {
   "command": "npx",
   "args": ["-y", "gemini-mcp-tool"]
   }

2. 导入到 Claude Code：
   bash
   claude mcp add-from-claude-desktop

配置

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

对于 NPX 使用（推荐）

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

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

对于全局安装

如果你进行了全局安装，请使用以下配置：

json
{
"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 脚本
• 让 Gemini 安全地测试 @script.py 并解释其功能
• 使用 Gemini 沙盒安装 numpy 并创建数据可视化
• 安全地测试这段代码：创建一个向 API 发送 HTTP 请求的脚本

工具（供 AI 使用）

这些工具是为 AI 助手设计的。

• ask-gemini: 向 Google Gemini 询问其观点。可用于一般问题或对文件进行复杂分析。
  • prompt (必需): 分析请求。使用 @ 语法包含文件或目录引用（例如，@src/main.js explain this code）或提出一般问题（例如，请通过网络搜索找到最新的新闻故事）。
  • 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/ 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 无关，也未得到 Google 的认可或赞助。