gemini-mcp

用途

gemini-mcp 用于管理 MCP（Model Context Protocol，模型上下文协议）服务器，从而为 Gemini CLI 扩展工具能力、自定义集成与企业工作流。MCP 允许 Gemini 连接外部服务器，这些服务器可提供额外工具与能力，例如数据库连接、API 集成、自定义业务逻辑、企业系统以及专用工具。

主要能力

• 服务器管理命令：
  • 列出已配置服务器：gemini mcp list
  • 查看服务器状态：gemini -i 后使用 /mcp
  • 测试服务器连接：gemini mcp test <server-name>
  • 添加服务器（交互式）：gemini mcp add
  • 手动添加服务器：gemini mcp add --name "my-server" --command "python" --args "-m my_mcp_server" --cwd "./mcp-servers/"
  • 移除服务器：gemini mcp remove <server-name>
• 配置文件支持：~/.gemini/mcp-servers.json 或 ./.gemini/mcp-servers.json，可配置 command、args、cwd、env、timeout、trust、includeTools、excludeTools、allowedDomains、maxConcurrent、rateLimit 等字段。
• 安全设置：可设置 trust（是否要求工具调用确认）、工具白名单/黑名单、允许域名、并发上限与速率限制。
• 构建 MCP 服务器：资料提供 Python（如 database_mcp_server.py）、Node.js（如 api-mcp-server.js）示例，以及 Docker 打包与运行方式。
• 与 YOLO 模式结合：可执行自动化数据操作、API 工作流编排、企业合规报告、基础设施监控等任务。
• 高级工作流：多服务器编排、按项目动态添加服务器、健康监控、负载均衡配置。
• 安全最佳实践：认证（bearer token）、TLS、工具限制、审计日志。
• 故障排查：查看日志、手动测试、检查端口冲突、调整超时、刷新工具列表、调试模式等。

使用方式

1. 通过 gemini mcp add 或直接编辑 mcp-servers.json 配置 MCP 服务器。
2. 使用 gemini mcp list、gemini mcp test 检查服务器状态与连接。
3. 在 Gemini CLI 中调用由 MCP 服务器提供的工具。
4. 如需自动化，可结合 gemini --yolo -p "..." 执行多步骤任务。
5. 构建自定义服务器时，可参考资料中的 Python、Node.js 或 Docker 示例。

适用场景

• 数据库操作（如 PostgreSQL 查询、数据同步）
• API 集成（如 Stripe 支付、订单处理）
• 自定义业务逻辑校验与定价计算
• 企业合规报告与基础设施健康检查
• 多服务集成的工作流自动化

限制与注意事项

• 资料强调 YOLO 模式的安全实践：只读或低风险操作可安全使用；写操作需谨慎，建议先审查再执行；生产数据删除、安全配置变更、超过阈值的金融交易等关键操作绝不应使用 YOLO，必须人工审批。
• 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。