教程
本页包含与 Gemini CLI 交互的教程内容。
设置模型上下文协议(MCP)服务器
[!警告] 使用第三方 MCP 服务器前,请确保您信任其来源并了解其提供的工具。使用第三方服务器的风险由您自行承担。
本教程演示如何设置 MCP 服务器,以 GitHub MCP 服务器为例。GitHub MCP 服务器提供了与 GitHub 仓库交互的工具,例如创建 issue 和对 pull request 发表评论。
先决条件
开始之前,请确保已安装并配置以下内容:
- 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:
Gemini CLI 会在您于 settings.json
文件中定义的 mcpServers
配置中使用此值。
启动 Gemini CLI 并验证连接
当您启动 Gemini CLI 时,它会自动读取您的配置并在后台启动 GitHub MCP 服务器。然后您可以使用自然语言提示要求 Gemini CLI 执行 GitHub 操作。例如: