⚡

GeminiMCP集成Skill gemini-mcp-integration

此技能提供Gemini CLI中Model Context Protocol (MCP)集成的专家指南，用于连接和管理MCP服务器，涵盖服务器配置（如HTTP、SSE、Stdio传输）、连接调试和工具权限管理。适用于AI模型集成、工具扩展和自动化场景，关键词：MCP, Gemini CLI, AI集成, 工具配置, 连接管理, 权限设置, 调试技巧。

AI智能体 0 次安装 0 次浏览 更新于 3/11/2026

name: gemini-mcp-integration description: Gemini CLI 中 Model Context Protocol (MCP) 集成的专家指南。涵盖 MCP 服务器配置（HTTP、SSE、Stdio）、连接管理和工具权限。用于在 Gemini 中添加 MCP 服务器、配置传输、解决 MCP 连接问题或管理工具权限时使用。委托给 gemini-cli-docs。 allowed-tools: 读取, 全局, 查找, 技能

Gemini MCP 集成

🚨 强制：首先调用 gemini-cli-docs

停止 - 在提供任何关于 Gemini MCP 的响应之前：

  1. 调用 gemini-cli-docs 技能
  2. 查询 特定的 MCP 主题
  3. 基于 官方加载的文档提供所有响应

概述

在 Gemini CLI 生态系统中连接和管理 Model Context Protocol (MCP) 服务器的专家技能。

何时使用此技能

关键词： MCP, model context protocol, mcp servers, mcp config, gemini mcp, stdio transport, sse transport, mcp tool permissions, mcp debugging

在以下情况下使用此技能：

  • 通过 settings.json 或 CLI（gemini mcp add）添加新的 MCP 服务器
  • 配置传输：httpUrl、url（SSE）或 command（Stdio）
  • 解决 MCP 连接状态（CONNECTING、DISCONNECTED）问题
  • 管理 MCP 工具权限（信任 vs 询问）
  • 将本地脚本集成为 MCP 服务器

MCP 服务器配置

MCP 服务器在 settings.json 的 mcpServers 对象中定义。

传输类型

  1. Stdio（command）： 运行本地可执行文件。适用于本地脚本/工具。

    "local-server": { "command": "node", "args": ["server.js"] }

  2. HTTP（httpUrl）： 通过标准 HTTP 连接。

  3. SSE（url）： 服务器发送事件，用于流式更新。

关键词注册（委托给 gemini-cli-docs）

主题 查询关键词
添加服务器 gemini mcp add command, mcpServers settings
传输 mcp transport types, stdio vs sse mcp
权限 mcp tool permissions, trust mcp server
问题解决 mcp connection error, debug mcp server

快速决策树

您想做什么？

  1. 连接本地工具 -> 查询 gemini-cli-docs：“configure stdio mcp server”
  2. 连接远程 API -> 查询 gemini-cli-docs：“configure http mcp server”
  3. 信任服务器 -> 查询 gemini-cli-docs：“mcp server trust settings”
  4. 列出工具 -> 查询 gemini-cli-docs：“list mcp tools command”
  5. 调试连接 -> 查询 gemini-cli-docs：“troubleshoot mcp connection”

常用命令

  • gemini mcp add - 交互式向导添加服务器。
  • /mcp - 列出连接的服务器及其状态。
  • gemini --debug - 查看原始 MCP 连接日志（解决连接问题的关键）。

测试场景

场景 1：添加 MCP 服务器

查询：“如何在 Gemini CLI 中添加 MCP 服务器？” 预期行为：

  • 技能在 “MCP” 或 “mcp servers” 上激活
  • 委托给 gemini-cli-docs 进行配置 成功标准：用户收到 mcpServers settings.json 结构

场景 2：配置传输

查询：“我应该为我的 MCP 服务器使用什么传输？” 预期行为：

  • 技能在 “mcp transport” 上激活
  • 提供 stdio、HTTP、SSE 的比较 成功标准：用户收到传输选择指导

场景 3：调试连接

查询：“我的 MCP 服务器无法连接到 Gemini” 预期行为：

  • 技能在 “mcp connection error” 上激活
  • 提供使用 --debug 标志的调试步骤 成功标准：用户收到问题解决工作流

参考

官方文档： 查询 gemini-cli-docs 以获取：

  • “mcp servers”
  • “mcp configuration”

版本历史

  • v1.1.0 (2025-12-01): 添加了测试场景部分
  • v1.0.0 (2025-11-25): 初始发布