VS Code MCP 工具怎样限制到当前工作区
来源:17golang原创
时间:2026-11-17 22:58:47 126浏览 收藏
如果你希望 MCP 服务器只服务当前项目,核心做法是:在工作区根目录创建 .mcp.json,把服务器写入顶层 mcpServers,再通过服务器的 tools 数组只列出需要的工具。不要把这类配置误放到个人配置中,也不要把“工作区信任”当成“工具调用审批”。
官方地址:https://code.visualstudio.com/docs/agents/reference/mcp-configuration
本文只讲工具授权范围与工作区配置,不讨论模型供应商。下面的界面图是原创操作示意图,不是 VS Code 截图,也不是实际运行结果。
一、先确定配置文件放在哪里
打开项目后,按 文件 → 打开文件夹 确认当前工作区根目录。然后在资源管理器最外层创建 .mcp.json。VS Code 当前文档把它作为工作区共享的便携式 MCP 配置,顶层键是 mcpServers。
如果你使用的是旧的编辑器管理格式,.vscode/mcp.json 使用的是 servers 顶层对象;它与 Copilot 原生读取的工作区根目录 .mcp.json 不是同一个格式。新项目优先采用根目录文件,避免“文件存在但当前会话看不到”的错觉。

二、写入一个最小的工作区 MCP 配置
在当前工作区根目录新建 .mcp.json,先用一个最小服务器确认配置来源正确。下面是便携式 Copilot 格式,JSON 本身不插入注释,字段含义放在代码块后说明。
{
"mcpServers": {
"projectTools": {
"type": "stdio",
"command": "node",
"args": ["./tools/mcp-server.js"],
"tools": ["readProjectFile", "searchProject"]
}
}
}
mcpServers是工作区根配置的顶层对象。projectTools是本项目内可识别的服务器名称,建议使用短且唯一的英文名。command与args只描述如何启动服务器;示例中的相对路径应当确实存在于当前项目。tools是允许交给当前会话的工具名集合,名称必须与服务器实际暴露的工具一致。
保存后,在命令面板执行 Chat: Open Customizations,进入 MCP Servers 查看服务器是否出现在当前工作区上下文。只配置文件不等于已经成功调用工具,后面还要看启用、信任和审批状态。
三、用 tools 列表限制工具,而不是只靠目录位置
把文件放在工作区,只能决定配置的归属范围;真正收窄工具集合,要在对应服务器对象里填写 tools。例如项目只需要读取和搜索,就不要写入能够修改文件、执行命令或访问外部服务的工具。
{
"mcpServers": {
"projectTools": {
"type": "stdio",
"command": "node",
"args": ["./tools/mcp-server.js"],
"tools": [
"readProjectFile",
"searchProject"
]
}
}
}
操作路径是 Chat: Open Customizations → MCP Servers → 选择 projectTools → Other Properties。在表单看不到 tools 时,直接打开来源 JSON 编辑;保存后重新打开服务器控制项。列表越小,当前服务器提供给会话的工具范围越清楚。

四、分别检查工作区信任、服务器启用和调用审批
配置写对后仍可能出现工具不可用。按以下路径逐项检查:
- 工作区信任:点击窗口底部的工作区信任提示,确认项目处于受信任状态。工作区根目录的
.mcp.json会继承 Workspace Trust,受限模式可能阻止服务器启动。 - 服务器状态:在 Chat: Open Customizations → MCP Servers 中确认
projectTools没有被禁用,也没有处于错误状态。 - 工具范围:展开服务器的 Tools 区域,确认只出现
readProjectFile与searchProject。 - 调用审批:当代理第一次调用工具时,检查确认框中的工具名称与参数,再选择允许一次或跳过。启用工具不会绕过审批策略。
这四步分别回答“能不能启动”“是否启用”“能用什么”“这一次是否批准”。修复其中一项,不会自动修复另外三项。
五、保存后怎样判断限制已经生效
在当前工作区发起一个需要读取项目文件的任务,观察工具选择器和调用确认框。可按下面的最小清单记录状态:
| 检查项 | 期望状态 | 不符合时先查什么 |
|---|---|---|
| 配置来源 | 工作区根目录 .mcp.json | 是否误编辑了全局文件或 .vscode/mcp.json |
| 顶层格式 | mcpServers | 是否把旧格式的 servers 直接复制过来 |
| 工具列表 | 只显示项目所需工具 | 服务器是否支持对应工具名,列表是否过宽 |
| 信任状态 | 工作区已信任 | 是否处于 Restricted Mode |
| 审批状态 | 确认框中的名称与参数符合预期 | 当前会话的审批策略与请求参数 |
六、常见问题:为什么工具仍然过多或完全不见
1. 把工作区文件写成了旧格式
根目录便携式配置使用 mcpServers;编辑器管理的 .vscode/mcp.json 才使用 servers。先确认文件位置,再确认顶层键,不要只看服务器名称是否相同。
2. 只写了服务器,没有填写 tools
服务器配置能启动,不代表工具范围已经按任务收窄。补上 tools 数组,并使用服务器实际暴露的工具名。若表单不显示该字段,使用 Other Properties 编辑来源 JSON。
3. 服务器运行了,但当前会话没有调用
检查服务器是否启用、当前会话选择的 harness 是否支持该配置,以及工具是否被工具选择器关闭。服务器“正在运行”只说明启动成功,不代表当前请求一定会调用它。
4. 配置里写入了密钥
不要把 token、密码或完整 Authorization 值提交到工作区文件。便携式配置可以使用环境变量引用,并在运行服务器的主机或容器中提供变量。
总结
限制 VS Code MCP 工具可以记成三层:用工作区根目录 .mcp.json 限定配置归属,用服务器对象里的 tools 限定工具集合,再用 Workspace Trust 和调用审批控制启动与每次使用。三层都检查清楚,当前项目才能得到可解释、可复查的 MCP 工具边界。
相关问题
工作区 .mcp.json 和 .vscode/mcp.json 能同时存在吗?
可以存在,但它们属于不同配置格式和管理路径。实际使用时应明确当前会话读取哪一种,避免同名服务器造成排查混乱。
把 tools 写成星号可以吗?
是否支持取决于当前 MCP 配置格式与服务器实现。若目标是最小权限,优先列出确实需要的工具名,不要用通配符扩大范围。
工作区信任能代替工具审批吗?
不能。信任决定服务器是否可以启动,审批决定具体调用是否允许,它们是独立控制点。
-
201 收藏
-
338 收藏
-
394 收藏
-
182 收藏
-
182 收藏
-
372 收藏
-
169 收藏
-
212 收藏
-
244 收藏
-
275 收藏
-
322 收藏
-
332 收藏
-
100 收藏
-
127 收藏
-
296 收藏
-
文章 · 软件教程 | 1天前 | 开发环境 · vs code · VS Code uid GID devcontainer.json Dev Containers remoteUser containerUser258 收藏
-
152 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习