教程

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

设置 Model Context Protocol (MCP) 服务器

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

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

前提条件

在开始之前，请确保你已安装并配置以下内容：

• Docker： 安装并运行 Docker。
• GitHub 个人访问令牌 (PAT)： 创建一个具有必要权限范围的新 classic 或 fine-grained 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 令牌

使用具有广泛权限范围的个人访问令牌（可以访问个人和私有仓库）可能导致私有仓库的信息泄露到公共仓库。我们建议使用不共享公共和私有仓库访问权限的细粒度访问令牌。

使用环境变量存储你的 GitHub PAT：

GITHUB_PERSONAL_ACCESS_TOKEN="pat_YourActualGitHubTokenHere"

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

启动 Gemini CLI 并验证连接

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

"get all open issues assigned to me in the 'foo/bar' repo and prioritize them"