Gemini MCP桥
本地MCP服务器，通过MCP将Gemini模型暴露给AI CLIs。
快速开始
npm install -g gemini-mcp-bridge- 运行指导设置：
gemini-mcp-bridge --setup gemini-mcp-bridge --stdio- 配置CLI以调用
gemini-mcp-bridge - 使用
gemini_generate_text在CLI中
如果您没有全局安装权限，请安装到用户前缀，然后 将MCP客户端指向完整命令路径：
npm install -g gemini-mcp-bridge --prefix ~/.npm-global
# Then set command = "$HOME/.npm-global/bin/gemini-mcp-bridge" in your MCP client config.手动身份验证（高级）：
- Gemini CLI“使用谷歌登录”（代码辅助）：运行
gemini选择选项1，然后使用GEMINI_MCP_BACKEND=code_assist（可选GEMINI_MCP_CODE_ASSIST_PROJECT_ID=...) - 订阅/OAuth（gcloud/ADC）：使用Vertex后端(
gcloud auth application-default login+GEMINI_MCP_BACKEND=vertex+GEMINI_MCP_VERTEX_PROJECT=...+GEMINI_MCP_VERTEX_LOCATION=...) - API密钥：保存到
~/.gemini-mcp-bridge/api-key（或/etc/gemini-mcp-bridge/api-key供共享使用），或设置GEMINI_API_KEY=.../GOOGLE_API_KEY=...（开发人员后端）
AI代理的安装
如果您是为用户安装此程序的AI代理，请咨询 代理商.md 对于关键的设置协议。
- 重要提示： 您必须使用以下命令显式配置项目根目录
GEMINI_MCP_FS_ROOT在服务器环境中避免“没有可用的MCP根”错误。看 用户手册>配置.
引导式设置（来源）
如果您从该仓库运行，安装向导可以指导后端选择， 写 ~/.gemini-mcp-bridge/config.json，可选地在同意的情况下存储API密钥， 并可选择运行 gcloud 顶点的步骤：
gemini-mcp-bridge --setup
# Or from source:
npm run setup特性
- 文本生成、图像/音频分析、图像生成/编辑（Nano Banana）、嵌入、模型列表、令牌计数
- 通过MCP根进行可选的仓库范围的文件系统访问，用于服务器端代码审查/修复
- 复合工具：
gemini_code_review（审查）和gemini_code_fix（基于差异的修复） - Auth选项：Code Assist（Gemini CLI“使用Google登录”）、Vertex（OAuth/ADC）或Developer API（API密钥）。带警告的可选API密钥回退。
- 可发现性资源和内置帮助
- 速率限制和每日代币预算（可选共享Redis存储）
- 通过以下方式批准预算
gemini-mcp-bridge --approve-budget - 具有轮换、保留和编辑功能的集中错误日志记录
文档
发展
- 安全扫描：
npm run security:scan（跑步npm audit --audit-level=high) - 生产咨询检查：
npm audit --omit=dev --audit-level=moderate
许可证
麻省理工学院