教程

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

代理技能

开始使用代理技能

设置 Model Context Protocol (MCP) 服务器

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

本教程演示了如何设置 MCP 服务器，以 GitHub 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 令牌

[!警告] 使用广泛范围的个人访问令牌，如果该令牌可以访问个人和私有仓库，可能会导致私有仓库的信息泄露到公共仓库中。我们建议使用不共享公共和私有仓库访问权限的细粒度访问令牌。

使用环境变量存储您的 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"

教程

教程