在 VS Code 中使用 MCP 服务器

模型上下文协议 (Model Context Protocol, MCP) 服务器使您能够在 VS Code 中通过额外工具扩展聊天体验，这些工具可用于连接数据库、调用 API 或执行专门任务。模型上下文协议 (MCP) 是一个开放标准，它使 AI 模型能够通过统一接口与外部工具和服务交互。本文将指导您设置 MCP 服务器并在 Visual Studio Code 中使用代理模式下的工具。

先决条件

• 安装最新版本的 Visual Studio Code
• 访问 Copilot

什么是 MCP？

模型上下文协议 (MCP) 提供了一种标准化的方式，使 AI 模型能够发现并与外部工具、应用程序和数据源交互。当您在 VS Code 中以代理模式向语言模型输入聊天提示时，模型可以调用各种工具来执行文件操作、访问数据库或调用 API 等任务，以响应您的请求。

在 VS Code 中启用 MCP 支持

集中管理 MCP 支持

您可以通过两种选项在组织中集中管理 MCP 支持

• 设备管理：通过组策略或配置配置文件集中启用或禁用组织中的 MCP 支持。了解更多关于使用设备管理管理 VS Code 设置的信息。

• GitHub Copilot 策略：使用 GitHub Copilot 策略控制组织中 MCP 服务器的可用性。在 GitHub Copilot 文档中了解更多关于在企业中管理 Copilot 的策略和功能的信息。

添加 MCP 服务器

您可以通过多种选项在 VS Code 中添加 MCP 服务器

• 直接安装：访问精选的 MCP 服务器列表，并在任何 MCP 服务器上选择安装，即可自动将其添加到您的 VS Code 实例中。
• 工作区设置：在您的工作区中添加一个 .vscode/mcp.json 文件，以配置工作区的 MCP 服务器并与团队成员共享配置。
• 用户设置：在您的用户配置中指定服务器（MCP: 打开用户配置），以在所有工作区中启用 MCP 服务器，并通过设置同步进行同步。
• 自动发现：启用自动发现 (chat.mcp.discovery.enabled) 其他工具中定义的 MCP 服务器，例如 Claude Desktop。

要查看和管理已配置的 MCP 服务器列表，请从命令面板运行MCP: 显示已安装的服务器命令，或访问扩展视图中的MCP 服务器 - 已安装部分。

添加 MCP 服务器后，您可以在代理模式下使用其提供的工具。

将 MCP 服务器添加到您的工作区

要为特定工作区配置 MCP 服务器，您可以在工作区文件夹中创建一个 .vscode/mcp.json 文件。这使您可以与项目团队成员共享服务器配置。

将 MCP 服务器添加到您的工作区

1. 在您的工作区中创建 .vscode/mcp.json 文件。

2. 选择添加服务器按钮以添加新服务器的模板。VS Code 为 MCP 服务器配置文件提供 IntelliSense。

   以下示例展示了如何配置一个 Perplexity MCP 服务器，其中 VS Code 会在服务器启动时提示您输入 API 密钥。了解更多关于配置格式的信息。

   {
     // 💡 Inputs are prompted on first server start, then stored securely by VS Code.
     "inputs": [
       {
         "type": "promptString",
         "id": "perplexity-key",
         "description": "Perplexity API Key",
         "password": true
       }
     ],
     "servers": {
       // https://github.com/github/github-mcp-server/
       "Github": {
         "url": "https://api.githubcopilot.com/mcp/"
       },
       // https://github.com/ppl-ai/modelcontextprotocol/
       "Perplexity": {
         "type": "stdio",
         "command": "npx",
         "args": ["-y", "server-perplexity-ask"],
         "env": {
           "PERPLEXITY_API_KEY": "${input:perplexity-key}"
         }
       }
     }
   }
   

3. 或者，从命令面板运行MCP: 添加服务器命令，选择要添加的 MCP 服务器类型并提供服务器信息。接下来，选择工作区设置，如果您的工作区中尚不存在 .vscode/mcp.json 文件，则创建它。

将 MCP 服务器添加到您的用户配置

要为您的所有工作区配置 MCP 服务器，您可以将服务器配置添加到您的用户配置中。这使您可以在多个项目中重用相同的服务器配置。

要将 MCP 添加到您的用户配置中，请运行MCP: 打开用户配置命令，该命令将在您的用户配置文件中打开 mcp.json 文件。如果文件不存在，VS Code 将为您创建它。

或者，从命令面板使用MCP: 添加服务器命令，提供服务器信息，然后选择全局将服务器配置添加到您的配置文件。

当您使用多个 VS Code 配置文件时，这允许您根据活动配置文件在不同的 MCP 服务器配置之间切换。例如，Playwright MCP 服务器可以在 Web 开发配置文件中配置，但不能在 Python 开发配置文件中配置。

开发容器支持

MCP 服务器可以通过 devcontainer.json 文件在开发容器中进行配置。这使您可以将 MCP 服务器配置作为容器化开发环境的一部分。

要在开发容器中配置 MCP 服务器，请将服务器配置添加到 customizations.vscode.mcp 部分

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

创建开发容器时，VS Code 会自动将 MCP 服务器配置写入远程 mcp.json 文件，使其在您的容器化开发环境中可用。

MCP 服务器的自动发现

VS Code 可以自动检测并重用您在其他工具（例如 Claude Desktop）中定义的 MCP 服务器。

通过 chat.mcp.discovery.enabled 设置启用自动发现。

配置格式

使用以下 JSON 配置格式定义 MCP 服务器。

• "servers": {}

  包含 MCP 服务器列表，并遵循 Claude Desktop 的配置格式。

  将服务器名称指定为键，并提供服务器配置作为值。VS Code 在 MCP 服务器列表中显示服务器名称。请遵循以下服务器名称命名约定：

  • 服务器名称使用 camelCase 格式，例如 "uiTesting"。
  • 避免使用空格或特殊字符。
  • 为每个服务器使用唯一名称以避免冲突。
  • 使用一个描述性名称来反映服务器的功能或品牌，例如 "github" 或 "database"。

  在服务器配置中提供以下字段。您可以在服务器配置中使用预定义变量，例如引用工作区文件夹 (${workspaceFolder})。

  `stdio` 的服务器配置

  字段	描述	示例
  类型	服务器连接类型。	"stdio"
  命令	启动服务器可执行文件的命令。该命令需要在您的系统路径中可用或包含其完整路径。 如果您使用 Docker，请勿使用分离选项。	"npx","node", "python", "docker"
  参数	传递给命令的参数数组。	["server.py", "--port", "3000"]
  环境变量	服务器的环境变量。	{"API_KEY": "${input:api-key}"}
  环境变量文件	加载额外环境变量的 .env 文件的路径。	"${workspaceFolder}/.env"

  `sse` 或 `http` 的服务器配置

  字段	描述	示例
  类型	服务器连接类型。VS Code 首先尝试可流式 HTTP 传输，如果 HTTP 不受支持，则回退到 SSE。	"sse", "http"
  URL	服务器的 URL。	"https://:3000"
  请求头	服务器的 HTTP 请求头。	{"API_KEY": "${input:api-key}"}

• "inputs": []

  允许您定义自定义配置值占位符，以避免在服务器配置中硬编码敏感信息，例如 API 密钥或密码。

  VS Code 会在服务器首次启动时提示您输入这些值，并安全地存储它们以供后续使用。为避免显示输入的值，请将 password 字段设置为 true。

  了解更多关于如何在 VS Code 中配置输入变量的信息。

配置示例

以下代码片段显示了一个 MCP 服务器配置示例，该配置指定了三个服务器并定义了 API 密钥的输入占位符。

// Example .vscode/mcp.json
{
  // 💡 Inputs will be prompted on first server start,
  //    then stored securely by VS Code.
  "inputs": [
    {
      "type": "promptString",
      "id": "perplexity-key",
      "description": "Perplexity API Key",
      "password": true
    }
  ],
  "servers": {
    // https://github.com/ppl-ai/modelcontextprotocol/
    "Perplexity": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "PERPLEXITY_API_KEY", "mcp/perplexity-ask"],
      "env": {
        "PERPLEXITY_API_KEY": "${input:perplexity-key}"
      }
    },
    // https://github.com/github/github-mcp-server/
    "Github": {
      "url": "https://api.githubcopilot.com/mcp/"
    },
    // https://github.com/modelcontextprotocol/servers/tree/main/src/fetch
    "fetch": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

在代理模式中使用 MCP 工具

添加 MCP 服务器后，您可以在代理模式下使用其提供的工具。

在代理模式下使用 MCP 工具

1. 打开聊天视图（⌃⌘I (Windows, Linux Ctrl+Alt+I)），然后从下拉菜单中选择代理模式。

   

2. 选择工具按钮以查看可用工具列表。

   （可选）选择或取消选择您要使用的工具。您可以通过在搜索框中键入来搜索工具。

   

   重要

   一个聊天请求一次最多可以启用 128 个工具。如果您选择的工具超过 128 个，请通过在工具选择器中取消选择一些工具来减少工具数量。

3. 您现在可以在聊天输入框中输入提示，并注意工具如何根据需要自动调用。

   默认情况下，当工具被调用时，您需要先确认操作才能运行。这是因为工具可能在您的本地机器上运行，并可能执行修改文件或数据的操作。

   使用继续按钮下拉选项，为当前会话、工作区或所有未来调用自动确认特定工具。

   

   提示

   您还可以通过键入 # 后跟工具名称来直接在提示中引用工具。您可以在所有聊天模式（询问、编辑和代理模式）中执行此操作。

4. （可选）在运行工具之前验证和编辑工具输入参数。

   

MCP 引导

MCP 服务器可以通过引导向您请求额外输入。当 MCP 服务器需要更多信息来完成任务时，它可以提示您提供具体细节，例如确认、配置值或操作所需的其他参数。

当 MCP 服务器发送引导请求时，VS Code 会向您显示一个对话框或输入字段，您可以在其中提供所请求的信息。这允许 MCP 服务器动态收集必要数据，而无需提前设置所有配置。

使用 MCP 资源

除了工具之外，MCP 服务器还可以提供资源，您可以将其用作聊天提示中的上下文。例如，文件系统 MCP 服务器可能提供对文件和目录的访问，或者数据库 MCP 服务器可能提供对数据库表的访问。

将 MCP 服务器的资源添加到您的聊天提示

1. 在聊天视图中，选择添加上下文 > MCP 资源

2. 从列表中选择资源类型，并提供可选的资源输入参数。

   

要查看 MCP 服务器的可用资源列表，请使用MCP: 浏览资源命令，或使用MCP: 列出服务器 > 浏览资源命令来查看特定服务器的资源。

MCP 工具可以将资源作为其响应的一部分返回。您可以使用保存按钮或通过将资源拖放到资源管理器视图来查看或将其保存到您的工作区。

使用 MCP 提示

MCP 服务器可以为常见任务提供预配置提示，因此您无需键入复杂的聊天提示。您可以通过在聊天输入框中键入 / 后跟提示名称（格式为 mcp.servername.promptname）来直接调用这些提示。可选地，提示可能会要求您提供额外的输入参数。

将相关工具分组到工具集

随着您添加更多的 MCP 服务器，工具列表可能会变得很长。这使得管理单个工具变得繁琐，例如当您想要定义一个可重用提示文件或自定义聊天模式时。

为了帮助您管理工具，您可以将相关工具分组到一个工具集中。工具集是您可以作为一个实体引用的单个工具的集合。工具集可以包含内置工具、MCP 工具或扩展提供的工具。

了解更多关于如何在 VS Code 中创建和使用工具集的信息。

管理 MCP 服务器

您可以在 VS Code 的扩展视图（⇧⌘X (Windows, Linux Ctrl+Shift+X)）中的MCP 服务器 - 已安装部分管理已安装的 MCP 服务器列表。这个专用视图使您可以轻松监控、配置和控制已安装的 MCP 服务器。

右键单击 MCP 服务器或选择齿轮图标以执行以下操作

• 启动/停止/重启：启动、停止或重启 MCP 服务器。
• 断开账户：断开用于与 MCP 服务器认证的账户。
• 显示输出：查看服务器日志以诊断问题。
• 显示配置：查看 MCP 服务器配置。
• 配置模型访问：配置 MCP 服务器可以访问哪些模型（采样）。
• 显示采样请求：查看 MCP 服务器发出的采样请求。
• 浏览资源：查看 MCP 服务器提供的资源。
• 卸载：从您的环境中卸载 MCP 服务器。

或者，从命令面板运行MCP: 列出服务器命令以查看已配置的 MCP 服务器列表。然后您可以选择一个服务器并对其执行操作。

命令行配置

您还可以使用 VS Code 命令行界面将 MCP 服务器添加到您的用户配置文件或工作区。

要将 MCP 服务器添加到您的用户配置文件，请使用 --add-mcp 命令行选项，并以 {\"name\":\"server-name\",\"command\":...} 的形式提供 JSON 服务器配置。

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

URL 处理程序

VS Code 还包含一个 URL 处理程序，您可以使用它来安装 MCP 服务器。要构建 URL，请按照您提供给 --add-mcp 的相同格式构造一个 obj 对象，然后使用以下逻辑创建链接

// For Insiders, use `vscode-insiders` instead of `code`
const link = `vscode:mcp/install?${encodeURIComponent(JSON.stringify(obj))}`;

此链接可以在浏览器中使用，也可以在命令行中打开，例如在 Linux 上通过 xdg-open $LINK。

跨设备同步 MCP 服务器

启用设置同步后，您可以在设备之间同步设置和配置，包括 MCP 服务器配置。这使您可以在所有设备上维护一致的开发环境并访问相同的 MCP 服务器。

要通过设置同步启用 MCP 服务器同步，请从命令面板运行设置同步: 配置命令，并确保MCP 服务器包含在同步配置列表中。

MCP 服务器故障排除和调试

MCP 输出日志

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

在聊天视图中选择错误通知，然后选择显示输出选项以查看服务器日志。或者，从命令面板运行MCP: 列出服务器，选择服务器，然后选择显示输出。

调试 MCP 服务器

您可以通过在 MCP 服务器配置中添加一个 dev 键来启用 MCP 服务器的开发模式。这是一个具有两个属性的对象：

• watch：一个文件 glob 模式，用于监视文件更改以重启 MCP 服务器。
• debug：使您能够使用 MCP 服务器设置调试器。

{
  "servers": {
    "gistpad": {
      "command": "node",
      "args": ["build/index.js"],
     "dev": {
       "watch": "build/**/*.js",
       "debug": { "type": "node" }
     },

常见问题

我能否控制使用哪些 MCP 工具？

是的，您有多种选项来控制哪些工具处于活动状态

• 在代理模式下，选择聊天视图中的工具按钮，并根据需要切换特定工具的开/关。
• 通过使用添加上下文按钮或键入 # 将特定工具添加到您的提示中。
• 对于更高级的控制，您可以使用 .github/copilot-instructions.md 来微调工具使用。

使用 Docker 时 MCP 服务器未启动

验证命令参数是否正确，并且容器未在分离模式 (-d 选项) 下运行。您还可以检查 MCP 服务器输出中是否有任何错误消息（参见故障排除）。

我收到错误消息：“每个请求不能有超过 128 个工具。”

由于模型限制，一个聊天请求一次最多可以启用 128 个工具。如果您选择的工具超过 128 个，请通过在聊天视图的工具选择器中取消选择一些工具或整个服务器来减少工具数量。

相关资源

• VS Code 精选 MCP 服务器列表
• 模型上下文协议文档
• 模型上下文协议服务器仓库
• 在 Visual Studio Code 中使用代理模式