Gemini MCP Tool：让 Claude 拥有 Gemini 的"千里眼"

背景故事

凌晨两点，你面对一个 3000 行的遗留代码库，Claude 给了你满屏的分析，却因为上下文不够用而遗漏了关键模块之间的调用关系。此时的你多么希望 Claude 能"读完全部代码"再做判断——但 token 上限就卡在那里。

Gemini MCP Tool 就是来解决这个问题的。它是一个开源的 MCP（Model Context Protocol）服务器，通过标准协议把 Google Gemini CLI 的超长上下文窗口能力"嫁接"到 Claude Desktop 和 Claude Code 上。有了它，Claude 不再受 token 焦虑困扰，可以直接对整个代码库、多个大文件做深度分析。

注：2026 年 6 月 18 日，Google 正式退役 Gemini CLI，项目随之切换到后继者 Antigravity CLI（agy），对大多数用户来说感知无差异，安装命令不变。

技术架构

Gemini MCP Tool 基于 TypeScript 开发，核心依赖只有两个：

• @modelcontextprotocol/sdk（^1.0.0）：MCP 协议的官方 SDK，处理服务发现、工具调用、进度通知等所有协议逻辑
• zod（^3.25.76）：运行时 Schema 校验，确保 AI 传来的参数合法

整体架构采用"后端抽象层"设计——src/backends/ 下同时维护了 gemini.ts（Gemini CLI）和 agy.ts（Antigravity CLI）两套实现，src/index.ts 通过 src/constants.ts 中的配置自动选择，代码耦合度低，扩展方便。

src/
├── index.ts          # MCP 服务器主入口，stdio 传输
├── constants.ts      # 协议常量与工具参数定义
├── backends/
│   ├── gemini.ts     # Gemini CLI 后端
│   ├── agy.ts        # Antigravity CLI 后端（当前默认）
│   └── agyTranscript.ts  # 回复解析
├── tools/
│   ├── ask-gemini.tool.ts    # 核心工具：向 Gemini 发问
│   ├── brainstorm.tool.ts     # 三人派对模式
│   ├── fetch-chunk.tool.ts    # 大文件分段读取
│   └── simple-tools.ts        # ping / help
└── utils/
    └── logger.ts      # 日志工具

核心功能

1. 突破 token 限制的大文件分析

用过 Claude Code 的都知道，当你要分析的文件超过几 KB 时，Claude 只能"盲人摸象"。Gemini MCP Tool 的解决思路很巧妙：让 Claude 主动调用 ask-gemini 工具，把分析任务委派给 Gemini CLI。Gemini 3.5 支持高达 100 万 token 的上下文窗口，足以一次性读完整个代码库。

# 在 Claude Code 中直接说自然语言
ask gemini to analyze @src/main.js and explain what it does
use gemini to summarize @. the current directory
analyze @package.json and tell me about dependencies

@ 语法是 Gemini CLI 的特色，代表"引用此文件/目录"。Claude 在调用 ask-gemini 时会把文件路径传递给 Gemini，后者在超大上下文中完成分析，结果再返回给 Claude。

2. 沙箱安全代码执行

sandbox-test 工具让你在 Gemini 的隔离沙箱里执行任意代码，不用担心搞崩本地环境：

use gemini sandbox to create and run a Python script that processes data

3. 三人派对头脑风暴

brainstorm 工具同时召唤 Claude 和 Gemini 对同一个问题发表看法，Claude Code 可以综合两份答案给出更全面的结论。

部署与上手

门槛极低，Node.js 16+ 即可。安装只需一行命令：

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

重启 Claude Code 后，输入 /mcp 即可验证 MCP 服务是否在线。没有任何 Dockerfile、没有 Docker、没有服务器——这就是一个本地工具，运行在 Claude 的同一台机器上。

对于企业用户，如果使用付费的 Gemini API Key，可以设置 GEMINI_MCP_BACKEND=gemini 继续使用原始 Gemini CLI，绕过 Antigravity 的实验性限制。

局限与争议

• Agon CLI 后端仍为实验性：agy 作为 Google 官方指定的 Gemini CLI 继任者，目前打印模式仅支持 Gemini 3.5 Flash，模型选择受限，且工具执行在沙箱模式下未完全隔离。
• 非原生集成：Gemini 的能力通过"委派"方式获取，延迟会比原生调用略高，且依赖两个 CLI 同时可用。
• License 为 NOASSERTION：虽然 package.json 声明 MIT，但仓库根目录 LICENSE 文件内容实际未填充 SPDX ID，发布到 npm 时可能引起合规审查。

行业意义

MCP 协议正在成为 AI 工具生态的"USB-C 接口"——不同供应商的 AI 助手和工具可以互相通信。Gemini MCP Tool 是这一趋势的典型案例：它不重新造轮子，而是用协议粘合两个强大的 CLI，让 Claude 获得 Gemini 的大上下文能力，让 Gemini 获得 Claude 的代码编辑能力。对于需要处理超大代码库的 AI 开发者，这是一个值得加入工具链的实用插件。