为 GitHub Copilot CLI 添加 MCP 服务器

模型上下文协议（MCP）是一项开放标准，定义了应用程序如何与大型语言模型（LLM）共享上下文。您可以将 MCP 服务器连接到 GitHub Copilot CLI，以便让 Copilot 访问外部工具、数据源和服务。有关 MCP 的概述，请参阅 关于模型上下文协议 (MCP)。

添加 MCP 服务器

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

有关安装说明、可用工具以及特定 MCP 服务器的 URL，请参阅 GitHub MCP 注册表。

使用 /mcp add 命令

1. 在交互模式下，输入 /mcp add。将显示配置表单。使用 Tab 在字段之间切换。

2. 在 服务器名称 旁，输入 MCP 服务器的唯一名称。此名称将在引用服务器时使用。

3. 在 服务器类型 旁，按对应的数字选择类型。可用的类型如下：

   • Local 或 STDIO：启动本地进程并通过标准输入/输出（stdin/stdout）进行通信。这两种选项的工作方式相同。STDIO 是标准的 MCP 协议类型名称，如果您希望配置兼容 VS Code、Copilot 云代理以及其他 MCP 客户端，请选择此项。
   • HTTP 或 SSE：连接远程 MCP 服务器。HTTP 使用可流式的 HTTP 传输。SSE 使用旧版的 Server‑Sent Events（服务器发送事件）传输，虽然在 MCP 规范中已被弃用，但仍为向后兼容而保留。

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

   • 如果您选择了 Local 或 STDIO

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

   • 如果您选择了 HTTP 或 SSE

     • 在 URL（地址）旁，粘贴远程服务器的 URL。例如，https://mcp.context7.com/mcp。
     • 在 HTTP Headers（HTTP 头部）旁，可选地以 JSON 形式指定 HTTP 头部。例如，{"CONTEXT7_API_KEY": "YOUR-API-KEY"}。

5. 在 Tools（工具）旁，指定应从服务器提供哪些工具。输入 * 以包含全部工具，或提供以逗号分隔的工具名称列表（无需加引号）。默认值为 *。

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

编辑配置文件

您也可以通过编辑位于 ~/.copilot/mcp-config.json 的配置文件来添加 MCP 服务器。这在您希望共享配置或一次性添加多个服务器时特别有用。

以下示例展示了包含本地服务器和远程 HTTP 服务器的配置文件

{
  "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": ["*"]
    }
  }
}

{
  "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 服务器配置的更多信息，请参阅 使用模型上下文协议 (MCP) 扩展 GitHub Copilot 云代理。

管理 MCP 服务器

您可以使用 Copilot CLI 中的以下 /mcp 命令来管理已配置的 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)
• 使用模型上下文协议（MCP）服务器扩展 GitHub Copilot Chat
• 使用模型上下文协议（MCP）扩展 GitHub Copilot 云代理