教程

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

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

CAUTION

在使用第三方 MCP 服务器之前，请确保您信任其来源并了解其提供的工具。您使用第三方服务器的风险自负。

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

先决条件

开始之前，请确保已安装并配置好以下项：

• Docker： 安装并运行 [Docker]。
• GitHub 个人访问令牌 (PAT)： 创建一个新的 [经典] 或 [精细化] PAT，并赋予必要的权限。

[Docker]：https://www.docker.com/ [经典]：https://github.com/settings/tokens/new [精细化]：https://github.com/settings/personal-access-tokens/new

指南

在 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_YourActualGitHubTokenHere"

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

启动 Gemini CLI 并验证连接

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

"获取分配给我的 'foo/bar' 存储库中的所有未关闭的 issue 并对其进行优先级排序"