当前位置:首页 > 文章列表 > 文章 > 软件教程 > VS Code MCP 工具怎样限制到当前工作区

VS Code MCP 工具怎样限制到当前工作区

来源:17golang原创 2026-11-17 22:58:47 0浏览 收藏

如果你希望 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删除
Inkscape Path Effects 怎样把对象轮廓转换为可编辑路径Inkscape Path Effects 怎样把对象轮廓转换为可编辑路径
上一篇
Inkscape Path Effects 怎样把对象轮廓转换为可编辑路径
Inkscape 怎样把参考对象的宽度分别应用给多个对象
下一篇
Inkscape 怎样把参考对象的宽度分别应用给多个对象
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1084次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1084次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1247次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1191次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1036次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码