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

添加 MCP 服务器

注意

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

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

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

使用 `/mcp add` 命令

在交互模式下，输入 /mcp add。将显示配置窗体。使用 Tab 在字段之间导航。
在 服务器名称旁边，输入 MCP 服务器的唯一名称。这是您用来指代服务器的名称。

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

     **本地** 或 **STDIO**：启动本地进程并通过标准输入/输出进行通信（`stdin`/`stdout`）。 这两个选项的工作方式相同。 
     **STDIO** 是标准的 MCP 协议类型名称，因此，如果您希望配置与 VS Code、Copilot编程助理 和其他 MCP 客户端兼容，请选择此选项。

     **HTTP** 或 **SSE**：连接到远程 MCP 服务器。 
     **HTTP** 使用可流式传输的 HTTP 传输。 
     **SSE** 将旧 HTTP 与 Server-Sent 事件传输配合使用，该传输在 MCP 规范中已弃用，但仍支持向后兼容。 <!-- markdownlint-disable-line GHD046 -->

其余字段取决于所选的服务器类型：
- 如果选择 “本地” 或 “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"}。
在 “工具” 旁边，指定服务器中的哪些工具应可用。输入 * 以包括所有工具，或提供逗号分隔的工具名称列表（无需引号）。默认值为 *。
按 Ctrl+S 保存配置。 MCP 服务器会立即添加并可用，无需重启 CLI。

编辑配置文件

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

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

JSON

{
  "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 服务器和特定工具，以确保使用它们。

延伸阅读

        [AUTOTITLE](/copilot/concepts/about-mcp)

        [AUTOTITLE](/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp)

        [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp)