Appearance
在 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,会出现交互式表单:
- Server Name:服务器唯一标识符,如
playwright - Server Type:选择以下三种之一
Local (STDIO):在本地启动一个子进程(最常见)HTTP:连接远程 HTTP 端点SSE:连接 Server-Sent Events 端点
- 命令/URL(根据类型不同)
- STDIO:填写启动命令,如
npx @playwright/mcp@latest - HTTP/SSE:填写远程 URL
- STDIO:填写启动命令,如
- Environment Variables:JSON 格式的环境变量
- 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 对应的配置中,两者独立。