登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  软件教程

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 和 mcpServers 配置
图1:操作示意图展示工作区根目录的 .mcp.json 与 MCP 服务器配置关系,不是截图或运行证据。

二、写入一个最小的工作区 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 工具范围界面说明图,展示两个启用工具以及工作区信任和调用审批状态
图2:结果示意图展示工具列表、工作区信任和调用审批是三个独立状态,不是截图或运行证据。

四、分别检查工作区信任、服务器启用和调用审批

配置写对后仍可能出现工具不可用。按以下路径逐项检查:

  1. 工作区信任:点击窗口底部的工作区信任提示,确认项目处于受信任状态。工作区根目录的 .mcp.json 会继承 Workspace Trust,受限模式可能阻止服务器启动。
  2. 服务器状态:在 Chat: Open Customizations → MCP Servers 中确认 projectTools 没有被禁用,也没有处于错误状态。
  3. 工具范围:展开服务器的 Tools 区域,确认只出现 readProjectFile 与 searchProject。
  4. 调用审批:当代理第一次调用工具时,检查确认框中的工具名称与参数,再选择允许一次或跳过。启用工具不会绕过审批策略。

这四步分别回答“能不能启动”“是否启用”“能用什么”“这一次是否批准”。修复其中一项,不会自动修复另外三项。

五、保存后怎样判断限制已经生效

在当前工作区发起一个需要读取项目文件的任务,观察工具选择器和调用确认框。可按下面的最小清单记录状态:

检查项期望状态不符合时先查什么
配置来源工作区根目录 .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 配置格式与服务器实现。若目标是最小权限,优先列出确实需要的工具名,不要用通配符扩大范围。

工作区信任能代替工具审批吗?

不能。信任决定服务器是否可以启动,审批决定具体调用是否允许,它们是独立控制点。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>