跳转至

教程

本页包含与 Gemini CLI 交互的教程内容。

设置模型上下文协议(MCP)服务器

[!警告] 使用第三方 MCP 服务器前,请确保您信任其来源并了解其提供的工具。使用第三方服务器的风险由您自行承担。

本教程演示如何设置 MCP 服务器,以 GitHub MCP 服务器为例。GitHub MCP 服务器提供了与 GitHub 仓库交互的工具,例如创建 issue 和对 pull request 发表评论。

先决条件

开始之前,请确保已安装并配置以下内容:

  • Docker: 安装并运行 Docker
  • GitHub 个人访问令牌(PAT): 创建一个新的 [经典] 或 [细粒度] PAT,并授予必要的作用域

操作指南

settings.json 中配置 MCP 服务器

在项目根目录下,创建或打开 .gemini/settings.json 文件。在文件中添加 mcpServers 配置块,该配置块提供了如何启动 GitHub MCP 服务器的指令。

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  }
}

设置您的 GitHub 令牌

[!CAUTION] 使用具有广泛权限的个人访问令牌(可访问个人和私有仓库)可能导致私有仓库信息泄露到公共仓库。我们建议使用细粒度访问令牌,该令牌不应同时拥有公共和私有仓库的访问权限。

使用环境变量存储您的 GitHub PAT:

GITHUB_PERSONAL_ACCESS_TOKEN="pat_您的实际GitHub令牌"

Gemini CLI 会在您于 settings.json 文件中定义的 mcpServers 配置中使用此值。

启动 Gemini CLI 并验证连接

当您启动 Gemini CLI 时,它会自动读取您的配置并在后台启动 GitHub MCP 服务器。然后您可以使用自然语言提示要求 Gemini CLI 执行 GitHub 操作。例如:

"获取 'foo/bar' 仓库中分配给我的所有未解决问题并确定优先级"