Skip to content

在 Copilot CLI 中添加 MCP 服务器后,AI 可以直接调用 Playwright 浏览器自动化、数据库查询、内部 API 等外部工具。支持交互式的 /mcp add 命令和直接编辑 JSON 配置文件两种方式,添加后无需重启即可使用。

GitHub Copilot CLI 添加 MCP 服务器:接入外部工具与数据源

什么是 MCP 服务器

MCP(Model Context Protocol)是一个开放协议,让 AI 代理可以通过标准接口调用外部工具。在 Copilot CLI 中添加 MCP 服务器后,Copilot 就能在处理任务时直接使用这些工具,比如:

  • 查询数据库
  • 通过 Playwright 控制浏览器
  • 读取 GitHub Issues 或 Jira 票据
  • 调用内部 API

方式一:交互式命令 /mcp add

在 Copilot CLI 中输入 /mcp add,会出现交互式表单:

  1. Server Name:服务器唯一标识符,如 playwright
  2. Server Type:选择以下三种之一
    • Local (STDIO):在本地启动一个子进程(最常见)
    • HTTP:连接远程 HTTP 端点
    • SSE:连接 Server-Sent Events 端点
  3. 命令/URL(根据类型不同)
    • STDIO:填写启动命令,如 npx @playwright/mcp@latest
    • HTTP/SSE:填写远程 URL
  4. Environment Variables:JSON 格式的环境变量
  5. Tools:要启用的工具列表,* 表示全部

Ctrl+S 保存,MCP 服务器立即可用,无需重启

方式二:直接编辑配置文件

配置文件路径:~/.copilot/mcp-config.json

STDIO 类型示例(Playwright)

json
{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {},
      "tools": ["*"]
    }
  }
}

HTTP 类型示例

json
{
  "mcpServers": {
    "my-api": {
      "type": "http",
      "url": "https://internal-api.company.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      },
      "tools": ["search", "get_item"]
    }
  }
}

SSE 类型示例

json
{
  "mcpServers": {
    "realtime-data": {
      "type": "sse",
      "url": "https://data.example.com/sse",
      "headers": {},
      "tools": ["*"]
    }
  }
}

管理已配置的 MCP 服务器

在 CLI 中使用 /mcp 系列命令管理:

命令功能
/mcp show列出所有已配置的 MCP 服务器
/mcp show playwright查看某个服务器的详情
/mcp edit playwright编辑服务器配置
/mcp delete playwright删除服务器
/mcp disable playwright临时禁用(不删除配置)
/mcp enable playwright重新启用

内置 GitHub MCP 服务器

Copilot CLI 内置了 GitHub MCP Server,无需额外配置:

  • 创建/查看/评论 Issues 和 PR
  • 查询仓库信息
  • 读写文件和代码

这个内置服务器在任何 Copilot CLI 会话中都可以直接使用。

安全注意事项

  • 配置文件中的 Token/密钥建议使用环境变量引用而非明文写入
  • HTTP/SSE 类型的远程服务器会接收 Copilot 的请求内容,添加前确认服务器的可信度
  • 企业管理员可以通过 Copilot 策略限制允许使用的 MCP 服务器范围

常见问题

Q: MCP 服务器需要 Node.js 吗?

A: STDIO 类型的 MCP 服务器取决于其实现,@playwright/mcp 等基于 npm 的服务器需要 Node.js。Python 写的 MCP 服务器需要 Python 环境。HTTP/SSE 类型不需要本地依赖。

Q: 添加了 MCP 服务器后,Copilot 会自动使用吗?

A: Copilot 会根据对话上下文判断是否需要调用 MCP 工具。你也可以在 Prompt 中明确引用工具名,强制调用。

Q: Copilot CLI 的 MCP 和 IDE 中 Copilot 的 MCP 是同一套配置吗?

A: 不是。Copilot CLI 的 MCP 配置在 ~/.copilot/mcp-config.json;IDE 中 Copilot 的 MCP 配置在 VS Code 设置或各 IDE 对应的配置中,两者独立。