教程

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

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

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

本教程以 GitHub MCP 服务器 为例，演示如何设置 MCP 服务器。GitHub MCP 服务器提供与 GitHub 存储库交互的工具，例如创建问题和评论拉取请求。

先决条件

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

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

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

启动 Gemini CLI 并验证连接

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

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