zen-code-docs/website/content/zh/cli/tutorials.md

教程

本页面包含与 Qwen Code 交互的教程。

设置 Model Context Protocol (MCP) 服务器

Caution

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

本教程演示如何设置 MCP 服务器，以 GitHub MCP 服务器 为例。GitHub MCP 服务器提供了与 GitHub 仓库交互的工具，例如创建 issue 和评论 pull request。

前置条件

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

• Docker： 安装并运行 Docker。
• GitHub Personal Access Token (PAT)： 创建一个新的 classic 或 fine-grained PAT，并授予必要的权限。

指南

在 settings.json 中配置 MCP server

在你的项目根目录下，创建或打开 .qwen/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

如果使用一个权限范围过大的 personal access token（PAT），并且该 token 可以访问个人或私有仓库，那么可能会导致私有仓库的信息泄露到公共仓库中。我们建议使用细粒度的访问 token，并且不要同时授予对公共和私有仓库的访问权限。

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

GITHUB_PERSONAL_ACCESS_TOKEN="pat_YourActualGitHubTokenHere"

Qwen Code 会在 settings.json 文件中你定义的 mcpServers 配置里使用这个值。

启动 Qwen Code 并验证连接

当你启动 Qwen Code 时，它会自动读取你的配置并在后台启动 GitHub MCP server。然后你就可以使用自然语言 prompt 来让 Qwen Code 执行 GitHub 操作。例如：

"获取 'foo/bar' 仓库中所有分配给我的 open issues 并进行优先级排序"