← 返回目录

Gemini MCP Tool

社区

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

GitHub 源仓库 ↗

★ 2.3k Stars 分类 · 开发工具非常热门

46FMRS · D

可靠性

8/20

安全与权限

7/20

维护活跃度

9/20

文档质量

12/20

安装易用性

10/20

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

查看 FMRS 评分方法 →

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

工具能力

ask-gemini

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

sandbox-test

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

Ping

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

Help

显示 Gemini CLI 帮助文本。

安装接入

需要 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 或 Claude Code 的开发者
需要分析大型文件和代码库的用户
已经配置 Gemini CLI 或 agy 的用户

不适合谁

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

所需权限

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

风险与副作用

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

常见排障

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

使用场景

分析大型文件或代码库

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

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

在 sandbox 中测试代码或脚本

支持客户端

Claude Desktop完整支持

Claude Code完整支持