教程

学习如何使用 Gemini CLI 的实用教程

首页 > CLI 指南 > 教程

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

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

⚠️ 重要提醒

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

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

前提条件

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

🐳 Docker

安装并运行 Docker

🔑 GitHub 个人访问令牌 (PAT)

创建一个新的经典或细粒度 PAT，具有必要的作用域。

操作指南

1. 在 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}"
      }
    }
  }
}

2. 设置您的 GitHub 令牌

🔐 安全警告

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

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

GITHUB_PERSONAL_ACCESS_TOKEN="pat_YourActualGitHubTokenHere"

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

3. 启动 Gemini CLI 并验证连接

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

💬 示例提示：

"获取 'foo/bar' 仓库中分配给我的所有开放问题并对其进行优先级排序"

更多教程示例

📝 文件操作

学习如何使用 Gemini CLI 进行文件读取、写入和修改操作。

gemini -p "读取 package.json 并总结项目信息"

🔍 代码分析

使用 @ 命令分析整个项目或特定文件。

@src/components/ 分析这些组件的架构

⚡ Shell 集成

结合 shell 命令进行自动化任务。

!git status
然后帮我创建一个合适的提交消息

最佳实践

🎯 使用技巧：

  • 明确的指令： 提供具体和详细的提示以获得更好的结果
  • 分步操作： 将复杂任务分解为更小的步骤
  • 上下文提供： 使用 @ 命令提供相关文件和目录的上下文
  • 安全确认： 始终检查工具执行的操作，特别是修改文件的操作

故障排除

🔧 常见问题：

  • MCP 服务器连接失败： 检查 Docker 是否正在运行，令牌是否正确设置
  • 权限被拒绝： 验证 GitHub PAT 具有所需的权限
  • 配置无效： 确保 settings.json 语法正确

相关文档：

↑ 顶部