教程

本页汇总与 Gemini CLI 交互的教程。

配置 Model Context Protocol (MCP) 服务器

[!CAUTION] 使用第三方 MCP 服务器前，请确认其来源可信并了解其提供的工具。使用第三方服务器的风险由你自行承担。

本示例演示如何配置 MCP 服务器，以 GitHub MCP server 为例。该 server 可用于与 GitHub 仓库交互，如创建 issue、评论 PR 等。

前置条件

开始前请确保：

Docker：已安装并运行 Docker。
GitHub Personal Access Token (PAT)：创建新的 classic 或 fine-grained Token，并赋予所需权限。

操作步骤

在 `settings.json` 中配置 MCP server

在项目根目录创建或打开 .gemini/settings.json，添加 mcpServers 配置块，指明如何启动 GitHub MCP server。

{
  "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 Token

[!CAUTION] 若使用拥有公共与私有仓库访问权限的 Token，可能会在公共仓库中泄露私有仓库信息。推荐使用精细权限（fine-grained）且不同时访问公开/私有仓库的 Token。

使用环境变量存储 GitHub PAT：

GITHUB_PERSONAL_ACCESS_TOKEN="pat_YourActualGitHubTokenHere"

CLI 会读取该变量并填入 settings.json 中的 mcpServers 配置。

启动 Gemini CLI 并验证连接

启动 Gemini CLI 后，会自动读取配置并在后台拉起 GitHub MCP server。你即可使用自然语言 Prompt 执行 GitHub 操作，例如：

"请获取 'foo/bar' 仓库中分配给我的所有开放 Issue，并按优先级排序"

教程