在 VS Code 中添加并管理 MCP 服务器

Model Context Protocol (MCP) 是一项开放标准，用于将 AI 模型连接到外部工具和服务。在 Visual Studio Code 中，MCP 服务器为文件操作、数据库或外部 API 等任务提供工具。MCP 服务器还可以提供资源、提示词和交互式应用。

关于 MCP 如何融入 AI 自定义框架的背景信息，请参阅自定义概念和工具概念。

本文介绍了如何添加、配置和管理 MCP 服务器。要了解如何在对话中使用工具，请参阅与智能体一起使用工具。

快速入门：在对话中使用 MCP 服务器

请按照以下步骤安装 MCP 服务器并在对话中使用其工具。本示例使用 Playwright MCP 服务器通过浏览器与网页进行交互。

1. 打开扩展视图（⇧⌘X (Windows, Linux Ctrl+Shift+X)），并在搜索框中输入 @mcp playwright。

2. 选择安装 (Install)，将 Playwright MCP 服务器安装到您的用户配置文件中。

3. 当出现提示时，确认您信任该服务器以启动它。VS Code 将发现该服务器的工具并使其在对话中可用。

4. 打开对话视图（⌃⌘I (Windows, Linux Ctrl+Alt+I)），并输入使用 Playwright 工具的提示词。例如

   Go to code.visualstudio.com, decline the cookie banner, and give me a screenshot of the homepage.
   

   VS Code 会调用 Playwright 工具在浏览器中打开页面并进行截图。系统可能会要求您确认每一次工具调用。

添加 MCP 服务器

从 MCP 服务器库安装 MCP 服务器

1. 打开扩展视图（⇧⌘X (Windows, Linux Ctrl+Shift+X)），并在搜索框中输入 @mcp。这将显示库中可用的 MCP 服务器列表。

2. 您可以将 MCP 服务器安装到用户配置文件或工作区中

   • 要安装到用户配置文件，请选择安装 (Install)。

   • 要安装到工作区，请右键点击该 MCP 服务器并选择安装到工作区 (Install in Workspace)。这会更新工作区中的 .vscode/mcp.json 文件。

3. 要查看 MCP 服务器详情，请在列表中选择该服务器以打开详情页面。

配置 mcp.json 文件

您可以通过编辑 mcp.json 文件手动配置 MCP 服务器。该文件有两个位置

• 工作区：在您的项目中创建或打开 .vscode/mcp.json。将此文件纳入版本控制，以便与团队共享 MCP 服务器配置。
• 用户配置文件：运行 MCP: 打开用户配置 (MCP: Open User Configuration) 命令，以打开用户配置文件文件夹中的 mcp.json 文件。在此配置的服务器在您的所有工作区中均可用。当您使用多个配置文件时，每个配置文件都可以拥有自己的 MCP 服务器配置。

您还可以在命令面板（⇧⌘P (Windows, Linux Ctrl+Shift+P)）中运行 MCP: 添加服务器 (MCP: Add Server)，通过引导流程添加服务器，并选择工作区 (Workspace) 或全局 (Global) 作为目标。

以下示例展示了一个配置了远程 MCP 服务器和本地 MCP 服务器的 mcp.json 文件

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp"
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@microsoft/mcp-server-playwright"]
    }
  }
}

VS Code 为配置文件提供 IntelliSense 支持。有关完整的配置模式和字段参考，请参阅 MCP 配置参考。

添加 MCP 服务器的其他选项

{
  "image": "mcr.microsoft.com/devcontainers/typescript-node:latest",
  "customizations": {
    "vscode": {
      "mcp": {
        "servers": {
          "playwright": {
            "command": "npx",
            "args": ["-y", "@microsoft/mcp-server-playwright"]
          }
        }
      }
    }
  }
}

code --add-mcp "{\"name\":\"my-server\",\"command\": \"uvx\",\"args\": [\"mcp-server-fetch\"]}"

其他 MCP 功能

除了工具之外，MCP 服务器还可以提供其他功能

沙箱化 MCP 服务器

在 macOS 和 Linux 上，您可以为本地运行的 stdio MCP 服务器启用沙箱，以限制其对文件系统和网络的访问。沙箱化服务器在隔离环境中运行，只能访问您明确允许的文件路径和网络域名。

要为服务器启用沙箱，请在 mcp.json 文件的服务器配置中设置 "sandboxEnabled": true。您可以通过添加包含特定文件系统和网络规则的 sandbox 对象，进一步自定义沙箱限制。

以下示例展示了如何为本地 MCP 服务器启用沙箱，并限制其仅能写入工作区文件以及访问特定 API 域名

{
  "servers": {
    "myServer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@example/mcp-server"],
      "sandboxEnabled": true,
      "sandbox": {
        "filesystem": {
          "allowWrite": ["${workspaceFolder}"]
        },
        "network": {
          "allowedDomains": ["api.example.com"]
        }
      }
    }
  }
}

启用沙箱后，来自服务器的工具调用会自动获得批准，因为它们在受控环境中运行。

有关完整的沙箱配置模式，请参阅 沙箱配置 参考。

管理 MCP 服务器

VS Code 提供了多种管理 MCP 服务器的选项，例如启动或停止服务器、查看日志、卸载或清除缓存的工具。

方法	描述
扩展视图	在MCP 服务器 - 已安装 (MCP SERVERS - INSTALLED) 部分右键点击服务器，或选择齿轮图标。
mcp.json 编辑器	打开配置文件并使用内联操作（代码镜头）。使用 MCP: 打开用户配置 (MCP: Open User Configuration) 或 MCP: 打开工作区文件夹配置 (MCP: Open Workspace Folder Configuration) 来打开该文件。
命令面板	运行 MCP: 列出服务器 (MCP: List Servers)，选择一个服务器，然后选择一个操作。

启用或禁用 MCP 服务器

您可以全局或针对特定工作区启用或禁用 MCP 服务器。当 MCP 服务器被禁用时，它不会启动，其工具、提示词、资源和 MCP 应用将从对话中排除。

要启用或禁用 MCP 服务器

• 在扩展视图的MCP 服务器 - 已安装 (MCP SERVERS - INSTALLED) 部分右键点击服务器，并选择启用 (Enable) 或禁用 (Disable)。
• 从命令面板运行 MCP: 列出服务器 (MCP: List Servers)，选择一个服务器，并选择启用 (Enable) 或禁用 (Disable)。
• 使用聊天自定义编辑器来切换服务器的启用状态。

启用/禁用状态与 mcp.json 中的服务器配置是分开存储的，因此不会影响共享的配置文件。

在 VS Code 中集中管理 MCP 服务器的访问权限

组织可以通过 GitHub 策略集中管理对 MCP 服务器的访问。了解更多关于 企业管理 MCP 服务器 的信息。

自动启动 MCP 服务器

当您添加 MCP 服务器或更改其配置时，VS Code 需要（重）启动服务器以发现其提供的工具。

您可以使用 chat.mcp.autoStart 在 VS Code 中打开 在 VS Code Insiders 中打开 设置（实验性）来配置 VS Code 在检测到配置更改时自动重启 MCP 服务器。

MCP 服务器信任

当您将 MCP 服务器添加到工作区或更改其配置时，需要确认您信任该服务器及其功能，然后才能启动它。当您首次启动服务器时，VS Code 会显示一个对话框以确认您信任该服务器。在对话框中，选择 MCP 服务器的链接以查看其配置。

如果您不信任该 MCP 服务器，它将不会被启动，聊天请求将继续进行，且不会使用该服务器提供的工具。

您可以通过从命令面板运行 MCP: 重置信任 (MCP: Reset Trust) 命令来重置 MCP 服务器的信任设置。

在不同设备间同步 MCP 配置

在启用了设置同步 (Settings Sync) 的情况下，您可以在不同设备间同步设置和配置，包括 MCP 服务器配置。这使您能够保持一致的开发环境，并在所有设备上访问相同的 MCP 服务器。

要通过设置同步来同步 MCP 服务器配置

1. 从命令面板运行 设置同步：配置 (Settings Sync: Configure) 命令

2. 在已同步配置列表中启用 MCP 服务器 (MCP Servers) 选项

MCP 服务器故障排除与调试

MCP 输出日志

当 VS Code 在 MCP 服务器中遇到问题时，它会在对话视图中显示错误指示器。

选择对话视图中的错误通知，然后选择显示输出 (Show Output) 选项以查看服务器日志。或者，从命令面板运行 MCP: 列出服务器 (MCP: List Servers)，选择该服务器，然后选择显示输出 (Show Output)。

常见问题

相关资源

• MCP 配置参考
• 使用工具与代理
• 模型上下文协议文档
• VS Code 中的 MCP 应用支持
• 发现并管理智能体插件，包括插件中的 MCP 服务器