在 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 编辑器	打开配置文件并使用内联操作 (Code Lens)。使用 MCP: 打开用户配置 或 MCP: 打开工作区文件夹配置 来打开该文件。
命令面板	运行 MCP: 列出服务器 (MCP: List Servers)，选择一个服务器，然后选择一个操作。

启用或禁用 MCP 服务器

你可以全局或为特定工作区启用或禁用 MCP 服务器。当 MCP 服务器被禁用时，它不会启动，其工具、提示词、资源和 MCP 应用也不会在聊天中出现。

要启用或禁用 MCP 服务器：

• 右键点击扩展视图中已安装的 MCP 服务器部分中的服务器，并选择启用 (Enable) 或禁用 (Disable)。
• 从命令面板运行 MCP: 列出服务器，选择一个服务器，然后选择启用或禁用。
• 使用智能体自定义编辑器 (Agent Customizations editor) 来切换服务器的启用状态。

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

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

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

自动启动 MCP 服务器

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

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

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