# 为 GitHub Copilot 命令行界面 (CLI) 添加 MCP 服务器

通过连接模型上下文协议 （MCP） 服务器来扩展 Copilot功能，以提供其他工具和上下文。

模型上下文协议 (MCP) 是一个开放标准，用于定义应用程序与大型语言模型 (LLM) 共享上下文的方式。 可以将 MCP 服务器连接到 GitHub Copilot 命令行界面 (CLI) 以提供 Copilot 对外部工具、数据源和服务的访问权限。 有关 MCP 的概述，请参阅“[关于模型上下文协议 (MCP)](/zh/copilot/concepts/about-mcp)”。

## 添加 MCP 服务器

> \[!NOTE]

```
          GitHub MCP 服务器内置在Copilot 命令行界面（CLI）一起，无需任何其他配置即可使用。 以下步骤用于添加其他 MCP 服务器。
```

可以使用 CLI 中的交互式 `/mcp add` 命令或直接编辑配置文件来添加 MCP 服务器。

有关特定 MCP 服务器的安装说明、可用工具和 URL，请参阅 [GitHub MCP 注册表](https://github.com/mcp)。

### 使用 `/mcp add` 命令

1. 在交互模式下，输入 `/mcp add`。 将显示配置窗体。 使用 <kbd>Tab</kbd> 在字段之间导航。

2. 在 **服务器名称**旁边，输入 MCP 服务器的唯一名称。 这是您用来指代服务器的名称。

3. 在 **“服务器类型”** 旁边，按相应的数字选择类型。 以下类型可用：

   * **本地** 或 **STDIO**：启动本地进程并通过标准输入/输出进行通信（`stdin`/`stdout`）。 这两个选项的工作方式相同。
     **STDIO** 是标准的 MCP 协议类型名称，因此，如果希望配置与 VS Code、 Copilot云代理MCP 客户端和其他 MCP 客户端兼容，请选择此选项。
   * **HTTP** 或 **SSE**：连接到远程 MCP 服务器。
     **HTTP** 使用可流式传输的 HTTP 传输。
     **SSE** 将旧 HTTP 与 Server-Sent 事件传输配合使用，该传输在 MCP 规范中已弃用，但仍支持向后兼容。 <!-- markdownlint-disable-line GHD046 -->

4. 其余字段取决于所选的服务器类型：

   * 如果选择 **“本地”** 或 **“STDIO**”：

     * 在 **Command** 旁边输入用于启动服务器的命令，包括任何参数。 例如，`npx @playwright/mcp@latest`。 这对应于 JSON 配置文件中的 `command` 属性和 `args` 属性。
     * 在 **环境变量**旁边，可以选择指定服务器所需的环境变量，例如 API 密钥或令牌，例如 JSON 键值对。 例如，`{"API_KEY": "YOUR-API-KEY"}`。 变量 `PATH` 会自动继承自您的环境。 必须在此处配置所有其他环境变量。

   * 如果选择 **HTTP** 或 **SSE**：

     * 在 **URL** 旁边，粘贴远程服务器 URL。 例如，`https://mcp.context7.com/mcp`。
     * 在 **HTTP 标头**旁边，可以选择将 HTTP 标头指定为 JSON。 例如，`{"CONTEXT7_API_KEY": "YOUR-API-KEY"}`。

5. 在 **“工具”** 旁边，指定服务器中的哪些工具应可用。 输入 `*` 以包括所有工具，或提供逗号分隔的工具名称列表（无需引号）。 默认值为 `*`。

6. 按 <kbd>Ctrl</kbd>+<kbd>S</kbd> 保存配置。 MCP 服务器会立即添加并可用，无需重启 CLI。

### 编辑配置文件

通过编辑 `~/.copilot/mcp-config.json` 处的配置文件，还可以添加 MCP 服务器。 如果要共享配置或一次性添加多个服务器，这非常有用。

以下示例显示了具有本地服务器和远程 HTTP 服务器的配置文件：

```json copy
{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {},
      "tools": ["*"]
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR-API-KEY"
      },
      "tools": ["*"]
    }
  }
}
```

有关 MCP 服务器配置的详细信息，请参阅 [将代理连接到外部工具](/zh/copilot/how-tos/use-copilot-agents/cloud-agent/extend-cloud-agent-with-mcp#writing-a-json-configuration-for-mcp-servers)。

## 管理 MCP 服务器

可以使用以下命令`/mcp`Copilot 命令行界面（CLI）管理配置的 MCP 服务器。

* **列出配置的 MCP 服务器：** 使用命令 `/mcp show`。 这将显示所有配置的 MCP 服务器及其当前状态。

* **查看有关特定服务器的详细信息：** 使用命令 `/mcp show SERVER-NAME`。 这会显示指定服务器的状态及其提供的工具列表。

* **编辑服务器的配置：** 使用命令 `/mcp edit SERVER-NAME`。

* **删除服务器：** 使用命令 `/mcp delete SERVER-NAME`。

* **禁用服务器：** 使用命令 `/mcp disable SERVER-NAME`。 禁用的服务器持续保持配置状态，但在当前会话中不被 Copilot 使用。

* **启用以前禁用的服务器：** 使用命令 `/mcp enable SERVER-NAME`。

## 使用 MCP 服务器

添加 MCP 服务器后， Copilot 可以在与提示相关时自动使用它提供的工具。 还可以在提示中直接引用 MCP 服务器和特定工具，以确保使用它们。

## 延伸阅读

* [关于模型上下文协议 (MCP)](/zh/copilot/concepts/about-mcp)
* [使用 MCP（模型上下文协议）服务器扩展 GitHub Copilot 对话助手](/zh/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp)
* [将代理连接到外部工具](/zh/copilot/how-tos/use-copilot-agents/cloud-agent/extend-cloud-agent-with-mcp)