Gemini MCP Tool

社区

在 Claude 中调用 Gemini 分析大型文件和代码库。

分类: 开发工具第 295 / 438
Stars: ★ 2.3k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 16+ · 预编译二进制
凭据: 需要 API Key / 凭据
许可证: 其他 / 未声明
最近提交: 4 个月前
工具数: 4

46FMRS · D

README 将其描述为通过 Gemini CLI 为 Claude Desktop 和 Claude Code 提供大型文件、代码库分析与 sandbox 测试能力的非官方第三方 MCP 服务器。README 展示 MIT 徽章和 MIT License 说明，但仓库元数据中的许可证标记为 NOASSERTION。

最强项 · 文档质量 12/20 最弱项 · 安全与权限 7/20

可靠性

8/20

安全与权限

7/20

维护活跃度

9/20

文档质量

12/20

安装易用性

10/20

查看各项评分依据

可靠性 8/20: README 描述了 ask-gemini、sandbox-test、Ping 和 Help 等工具及参数，正常启动路径看起来可行。但未提供已提交的测试或 CI 证据，SERVER MANIFEST 未缓存；Gemini CLI 退休、agy 实验性后端、模型和 sandbox 可能无法兑现，以及超时和错误路径仍存在不确定性，因此扣分。
安全与权限 7/20: README 明确说明请求会交给 Gemini CLI/agy，且 agy 在 -p 模式下不进行工具执行沙箱隔离；sandbox 只是可选参数，未证明默认使用最小权限、数据边界、凭据处理或危险操作确认。未发现凭据窃取或明确的不可逆破坏默认行为，但外部模型传输和未隔离执行风险使分数受限。
维护活跃度 9/20: 仓库未归档，并有发布徽章、贡献指南和较多公开活动信号。但仅凭 README 无法验证近期提交、发布频率、依赖更新、维护者身份、安全响应渠道或实际许可证文件；元数据为 NOASSERTION，而 README 声称 MIT，存在许可证证据不一致，因此扣分。
文档质量 12/20: README 覆盖安装、客户端配置、工具名称、主要参数、@ 文件引用、sandbox 用法、环境变量、平台示例和部分已知限制。扣分原因是完整文档、故障排查、认证、成本、网络数据流和 manifest 未提供；Gemini CLI 退休与前置条件说明也存在时效和表述复杂性。
安装易用性 10/20: 提供 npx 一行安装命令、Node.js 要求、Gemini/agy 前置条件、Claude Desktop 配置和验证方式，主流客户端路径清楚。扣分原因是需要额外安装并登录 CLI，后端迁移增加复杂度，agy 路径实验性，Windows 命令示例较脆弱，且未提供可验证的测试或跨平台连接证据。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件执行命令或代码访问网络

适合谁

使用 Claude Desktop 或 Claude Code 的开发者
需要分析大型文件和代码库的用户
已经配置 Gemini CLI 或 agy 的用户

不适合谁

不使用 Claude Desktop 或 Claude Code 的用户
未安装或未配置所需 CLI 的用户
需要官方 Google 支持或官方集成的用户

所需权限

需要访问被 @ 语法引用的本地文件或目录
需要运行 Gemini CLI 或 agy 子进程
需要使用已配置 CLI 的登录或 API 访问权限

风险与副作用

agy 后端在 -p 模式下的工具执行未被 sandbox 隔离
被引用的文件内容会提交给所选 CLI 后端进行分析
模型、sandbox 或后端设置在 agy 中可能无法完全满足；工具会发出提示
配额、认证和 CLI 错误可能直接返回给调用方

安装接入

准备工作

运行环境：Node.js 16+ · 预编译二进制

其他可选配置项（3 个）

GEMINI_MCP_BACKEND 可选选择后端：gemini 或 agy/antigravity；未设置时自 2026-06-18 起默认使用 agy。

AGY_CLI_PATH 可选 agy 二进制的完整路径，当 agy 不在服务器 PATH 中时设置。

GEMINI_MCP_TIMEOUT 可选 CLI 运行的整体超时时间（分钟），默认 45。

需要 Node.js 16 或更高版本，并安装、配置 Gemini CLI；受影响的用户也可安装 Antigravity CLI（agy）并登录。使用 claude mcp add gemini-cli -- npx -y gemini-mcp-tool 注册，或将提供的配置加入 Claude Desktop 后重启终端会话。Gemini CLI 退休后的企业、标准许可或付费 API key 用户可设置 GEMINI_MCP_BACKEND=gemini。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

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

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Code 中输入 /mcp 确认 gemini-cli MCP 服务器已激活，工具列表中应出现 ask-gemini、sandbox-test、Ping、Help 等工具。

常见排障

在 Claude Code 中运行 `/mcp` 确认服务器已激活
确认 Node.js 版本至少为 16
确认 Gemini CLI 或 agy 已安装、可执行并已登录
如果 agy 不在 PATH 中，设置 `AGY_CLI_PATH`
检查 `GEMINI_MCP_BACKEND` 是否为 `gemini`、`agy` 或 `antigravity`
必要时检查 `GEMINI_MCP_TIMEOUT`；默认超时为 45 分钟

试试这样问

连接成功后，可以直接对 AI 助手这样说：

ask gemini 分析 @src/main.js 并解释这段代码的功能
ask gemini 总结 @ 当前目录的内容
use gemini sandbox 创建并运行一个处理数据的 Python 脚本
ask gemini 搜索最新的科技新闻

工具能力 4

ask-gemini 只读

向 Gemini 提交一般问题或复杂分析请求，可使用 @ 语法引用文件或目录；支持可选模型和 sandbox 参数。

sandbox-test 写入

始终在 Gemini sandbox 模式中安全测试代码或命令。

Ping 只读

回显消息，用于测试连接。

Help 只读

显示 Gemini CLI 帮助文本。

使用场景

分析大型文件或代码库

使用 @ 语法解释文件和目录

向 Gemini 提问并获取第二种观点

在 sandbox 中测试代码或脚本

支持客户端

Claude Desktop

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

Gemini MCP Tool 是一个非官方第三方 MCP 服务器，通过 Gemini CLI 或默认的 Antigravity CLI（agy）让 AI 助手向 Gemini 提问、分析文件和代码库，并利用其大 token 窗口处理大型分析任务。