{"meta":{"title":"为 GitHub Copilot 命令行界面 (CLI) 添加 MCP 服务器","intro":"通过连接模型上下文协议 （MCP） 服务器来扩展 Copilot功能，以提供其他工具和上下文。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/copilot","title":"GitHub Copilot"},{"href":"/zh/copilot/how-tos","title":"操作方法"},{"href":"/zh/copilot/how-tos/copilot-cli","title":"Copilot 命令行界面（CLI）"},{"href":"/zh/copilot/how-tos/copilot-cli/customize-copilot","title":"自定义 Copilot CLI"},{"href":"/zh/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers","title":"添加 MCP 服务器"}],"documentType":"article"},"body":"# 为 GitHub Copilot 命令行界面 (CLI) 添加 MCP 服务器\n\n通过连接模型上下文协议 （MCP） 服务器来扩展 Copilot功能，以提供其他工具和上下文。\n\n模型上下文协议 (MCP) 是一个开放标准，用于定义应用程序与大型语言模型 (LLM) 共享上下文的方式。 可以将 MCP 服务器连接到 GitHub Copilot 命令行界面 (CLI) 以提供 Copilot 对外部工具、数据源和服务的访问权限。 有关 MCP 的概述，请参阅“[关于模型上下文协议 (MCP)](/zh/copilot/concepts/about-mcp)”。\n\n## 添加 MCP 服务器\n\n> \\[!NOTE]\n\n```\n          GitHub MCP 服务器内置在Copilot 命令行界面（CLI）一起，无需任何其他配置即可使用。 以下步骤用于添加其他 MCP 服务器。\n```\n\n可以使用 CLI 中的交互式 `/mcp add` 命令或直接编辑配置文件来添加 MCP 服务器。\n\n有关特定 MCP 服务器的安装说明、可用工具和 URL，请参阅 [GitHub MCP 注册表](https://github.com/mcp)。\n\n### 使用 `/mcp add` 命令\n\n1. 在交互模式下，输入 `/mcp add`。 将显示配置窗体。 使用 <kbd>Tab</kbd> 在字段之间导航。\n\n2. 在 **服务器名称**旁边，输入 MCP 服务器的唯一名称。 这是您用来指代服务器的名称。\n\n3. 在 **“服务器类型”** 旁边，按相应的数字选择类型。 以下类型可用：\n\n   * **本地** 或 **STDIO**：启动本地进程并通过标准输入/输出进行通信（`stdin`/`stdout`）。 这两个选项的工作方式相同。\n     **STDIO** 是标准的 MCP 协议类型名称，因此，如果希望配置与 VS Code、 Copilot云代理MCP 客户端和其他 MCP 客户端兼容，请选择此选项。\n   * **HTTP** 或 **SSE**：连接到远程 MCP 服务器。\n     **HTTP** 使用可流式传输的 HTTP 传输。\n     **SSE** 将旧 HTTP 与 Server-Sent 事件传输配合使用，该传输在 MCP 规范中已弃用，但仍支持向后兼容。 <!-- markdownlint-disable-line GHD046 -->\n\n4. 其余字段取决于所选的服务器类型：\n\n   * 如果选择 **“本地”** 或 **“STDIO**”：\n\n     * 在 **Command** 旁边输入用于启动服务器的命令，包括任何参数。 例如，`npx @playwright/mcp@latest`。 这对应于 JSON 配置文件中的 `command` 属性和 `args` 属性。\n     * 在 **环境变量**旁边，可以选择指定服务器所需的环境变量，例如 API 密钥或令牌，例如 JSON 键值对。 例如，`{\"API_KEY\": \"YOUR-API-KEY\"}`。 变量 `PATH` 会自动继承自您的环境。 必须在此处配置所有其他环境变量。\n\n   * 如果选择 **HTTP** 或 **SSE**：\n\n     * 在 **URL** 旁边，粘贴远程服务器 URL。 例如，`https://mcp.context7.com/mcp`。\n     * 在 **HTTP 标头**旁边，可以选择将 HTTP 标头指定为 JSON。 例如，`{\"CONTEXT7_API_KEY\": \"YOUR-API-KEY\"}`。\n\n5. 在 **“工具”** 旁边，指定服务器中的哪些工具应可用。 输入 `*` 以包括所有工具，或提供逗号分隔的工具名称列表（无需引号）。 默认值为 `*`。\n\n6. 按 <kbd>Ctrl</kbd>+<kbd>S</kbd> 保存配置。 MCP 服务器会立即添加并可用，无需重启 CLI。\n\n### 编辑配置文件\n\n通过编辑 `~/.copilot/mcp-config.json` 处的配置文件，还可以添加 MCP 服务器。 如果要共享配置或一次性添加多个服务器，这非常有用。\n\n以下示例显示了具有本地服务器和远程 HTTP 服务器的配置文件：\n\n```json copy\n{\n  \"mcpServers\": {\n    \"playwright\": {\n      \"type\": \"local\",\n      \"command\": \"npx\",\n      \"args\": [\"@playwright/mcp@latest\"],\n      \"env\": {},\n      \"tools\": [\"*\"]\n    },\n    \"context7\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.context7.com/mcp\",\n      \"headers\": {\n        \"CONTEXT7_API_KEY\": \"YOUR-API-KEY\"\n      },\n      \"tools\": [\"*\"]\n    }\n  }\n}\n```\n\n有关 MCP 服务器配置的详细信息，请参阅 [将代理连接到外部工具](/zh/copilot/how-tos/use-copilot-agents/cloud-agent/extend-cloud-agent-with-mcp#writing-a-json-configuration-for-mcp-servers)。\n\n## 管理 MCP 服务器\n\n可以使用以下命令`/mcp`Copilot 命令行界面（CLI）管理配置的 MCP 服务器。\n\n* **列出配置的 MCP 服务器：** 使用命令 `/mcp show`。 这将显示所有配置的 MCP 服务器及其当前状态。\n\n* **查看有关特定服务器的详细信息：** 使用命令 `/mcp show SERVER-NAME`。 这会显示指定服务器的状态及其提供的工具列表。\n\n* **编辑服务器的配置：** 使用命令 `/mcp edit SERVER-NAME`。\n\n* **删除服务器：** 使用命令 `/mcp delete SERVER-NAME`。\n\n* **禁用服务器：** 使用命令 `/mcp disable SERVER-NAME`。 禁用的服务器持续保持配置状态，但在当前会话中不被 Copilot 使用。\n\n* **启用以前禁用的服务器：** 使用命令 `/mcp enable SERVER-NAME`。\n\n## 使用 MCP 服务器\n\n添加 MCP 服务器后， Copilot 可以在与提示相关时自动使用它提供的工具。 还可以在提示中直接引用 MCP 服务器和特定工具，以确保使用它们。\n\n## 延伸阅读\n\n* [关于模型上下文协议 (MCP)](/zh/copilot/concepts/about-mcp)\n* [使用 MCP（模型上下文协议）服务器扩展 GitHub Copilot 对话助手](/zh/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp)\n* [将代理连接到外部工具](/zh/copilot/how-tos/use-copilot-agents/cloud-agent/extend-cloud-agent-with-mcp)"}