VS Code + Copilot 最简可执行 MCP 配置

核心说明:此为 Copilot 可直接识别并执行的最简 MCP(Model Context Protocol)配置,无需复杂依赖,仅实现「读取当前项目根目录文件」的基础功能(可直接测试),适配 VS Code + GitHub Copilot 环境。

一、前置条件(必满足,否则无法执行)

  1. 已安装并启用 GitHub Copilot 扩展(不是 Copilot Chat 单独扩展,需完整安装);

  2. VS Code 版本 ≥ 1.90(低版本不支持内置 MCP 解析);

  3. 本地已安装 Node.js(≥16.x,用于运行 MCP 服务器,可通过 node -v 验证);

  4. 打开任意 Next.js / 普通 JS 项目(MCP 需要依托项目工作区运行)。

二、最简 MCP 配置(仅 1 个文件,直接复制创建)

在项目根目录新建 .vscode/mcp.json 文件(路径固定,Copilot 仅识别此路径下的 MCP 配置),粘贴以下代码(无需修改任何内容):

cpp 复制代码
{
  "servers": {
    "file-system": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
      "enabled": true
    }
  },
  "defaultServers": ["file-system"]
}

三、核心说明(极简,看懂关键即可)

  • file-system:MCP 服务器名称(自定义,此处用系统文件读取服务器,Copilot 可直接调用);

  • @modelcontextprotocol/server-filesystem:官方轻量文件读取 MCP 服务器(npx 会自动下载,无需手动安装);

  • enabled: true:启用该 MCP 服务器,Copilot 可直接调用其能力;

  • defaultServers:设置默认启用的 MCP 服务器,无需手动激活。

四、执行测试(3步搞定,必生效)

  1. 保存 .vscode/mcp.json 文件后,重启 VS Code(确保 Copilot 加载 MCP 配置);

  2. 打开 Copilot 聊天窗口(快捷键:Ctrl+Alt+I);

  3. 在聊天框输入指令:用 MCP 读取当前项目根目录的所有文件列表,点击发送,Copilot 会自动调用 MCP 服务器,输出项目根目录文件(如 package.json、next.config.js 等)。

执行结果

五、关键注意事项(必看,避免踩坑)

  • 路径必须是 .vscode/mcp.json,不可修改路径和文件名(Copilot 仅识别此固定路径);

  • 无需手动启动 MCP 服务器:Copilot 执行指令时,会自动通过 npx 下载并启动 MCP 服务器,无需额外终端操作;

  • 测试失败排查:① 重启 VS Code;② 确认 Node.js 已安装;③ 确认 Copilot 已登录且扩展启用;④ 指令不要修改,严格按步骤输入;

  • 此 MCP 仅实现「文件读取」基础功能,无复杂权限,适合新手测试,可直接复用。

六、补充说明

执行成功后,可修改指令测试更多 MCP 能力,比如:用 MCP 读取 package.json 文件的内容,Copilot 会自动调用该 MCP 服务器完成操作,无需额外配置。

相关推荐
Summer-Bright10 小时前
AI 软件简报 07.11-07.15:DeepSeek天价融资、Copilot用户叛逃、中国AI新规落地
人工智能·软件工程·copilot
风向决定发型d7821 天前
Github Copilot 新手极速上手指南
人工智能·github·copilot
Ai_easygo3 天前
2026 AI编程工具年终横评——Cursor vs Claude Code vs Copilot vs Windsurf,到底选哪个?
copilot·ai编程
LibraJM5 天前
一种适合程序员的 Agent 协作方式的实践
c#·copilot·agents
ShallWeL7 天前
Cursor、Copilot、Claude Code 怎么选
人工智能·copilot·ai编程·agi·ai-native
粤M温同学7 天前
VS Code GitHub Copilot插件中配置 DeepSeek 模型
github·copilot
欣慰的猫咪8 天前
GitHub Copilot 正式成为 JetBrains AI Assistant 的原生默认 Agent 之一
人工智能·github·copilot
阿拉雷️9 天前
AI编程工作流搭建实战:用Codex+Claude+GitHub Copilot搭了一套完整流水线
github·copilot·ai编程
cooldream200910 天前
AI编程系列之1:AI 编程的三种范式——从 Copilot 到 Agent 到 Spec
人工智能·copilot·ai编程·spec
tuddy78946412 天前
Privazer 源码级避坑指南:从编译到部署的深度解析
网络·copilot