1. 服务概述
一句话简介：轻量级MCP服务器，通过官方CLI与Google Gemini AI交互，零API成本，支持通用查询、文件分析和网络搜索
- 服务名称：Gemini MCP Server (gemini-bridge)
- 版本号：最新版本
- 开发者/提供方：eLyiN
- 协议类型：MCP (Model Context Protocol)
2. 核心功能
该MCP服务提供的主要功能点：
- 直接CLI集成：使用官方Gemini CLI，零API成本
- 通用查询：通过consult_gemini发送直接问题或提示
- 文件分析：通过consult_gemini_with_files附加文件进行详细分析
- 网络搜索：通过web_search获取网络搜索结果
- 模型选择：支持flash、pro、flash-lite等多种模型
- 无状态操作：独立执行查询，无会话或缓存
- 生产就绪：强大的错误处理，可配置超时
- 多客户端支持：支持Claude Code、Cursor、VS Code、Windsurf等
3. 使用场景
该服务适合在以下情况下使用：
- 需要通过AI助手与Gemini AI交互
- 需要进行代码审查和多文件分析
- 需要获取最新的网络信息
- 需要比较不同AI模型的输出
- 需要零API成本的Gemini访问
- 需要在多个MCP客户端中使用Gemini
4. 接入方式
4.1 服务端点
该服务作为本地MCP服务器运行，通过标准输入/输出通信。
4.2 认证与权限
需要安装并认证Gemini CLI：
# 安装Gemini CLI npm install -g @google/gemini-cli # 认证 gemini auth login # 验证安装 gemini --version4.3 数据格式
服务使用JSON格式进行数据交换，遵循MCP协议规范。
4.4 服务器配置
在Claude Code配置中添加服务：
# 推荐：使用uvx claude mcp add gemini-bridge -s user -- uvx gemini-bridge # 或手动配置 { "mcpServers": { "gemini-bridge": { "command": "uvx", "args": ["gemini-bridge"], "env": {} } } }5. 接口定义
该服务提供三个MCP工具：
| 工具名称 | 功能描述 | 主要参数 |
|---|---|---|
| consult_gemini | 发送直接查询到Gemini | query, directory, model(可选), timeout_seconds(可选) |
| consult_gemini_with_files | 附加文件进行详细分析 | query, directory, files, model(可选), mode(可选), timeout_seconds(可选) |
| web_search | 带网络搜索上下文的查询 | query, directory, model(可选), timeout_seconds(可选) |
6. 快速开始
6.1 环境要求
- Python 3.10+
- Node.js和npm（用于Gemini CLI）
- Gemini CLI已认证
6.2 示例代码
安装：
# 从PyPI安装 pip install gemini-bridge # 添加到Claude Code claude mcp add gemini-bridge -s user -- uvx gemini-bridge使用示例：
# 基础代码分析 consult_gemini( query="What authentication patterns are used in this project?", directory="/Users/dev/my-project" ) # 详细文件审查 consult_gemini_with_files( query="Review these files and suggest security improvements", directory="/Users/dev/my-project", files=["src/auth.py", "src/middleware.py"], model="pro" ) # 多文件分析 consult_gemini_with_files( query="Compare these database implementations", directory="/Users/dev/my-project", files=["src/db/postgres.py", "src/db/sqlite.py"], mode="at_command" ) # 网络搜索 web_search( query="latest Python version and new features in 3.13", model="flash" )超时配置：
# 设置自定义超时（120秒） claude mcp add gemini-bridge -s user --env GEMINI_BRIDGE_TIMEOUT=120 -- uvx gemini-bridge7. 注意事项
- 零API成本：使用官方Gemini CLI，无需API密钥费用
- 默认超时：60秒，可通过环境变量或参数覆盖
- 文件大小限制：内联模式约256KB/文件，512KB/请求
- 模型支持：flash、pro、flash-lite、2.5-lite、3-pro、3-flash等
- 无状态操作：每次调用独立，无会话状态
- 多客户端兼容：支持Claude Code、Cursor、VS Code、Windsurf、Cline等
- 错误处理：清晰的错误消息，快速失败方法
- 许可证：MIT许可证
- 依赖最小：仅需mcp>=1.0.0和Gemini CLI
