在 VS Code 中使用 MCP 服务器

模型上下文协议 (MCP) 是一个开放标准，它允许 AI 模型通过统一接口使用外部工具和服务。在 VS Code 中，MCP 服务器为文件操作、数据库或与外部 API 交互等任务添加了工具。

本文将指导你设置 MCP 服务器并在 Visual Studio Code 中以代理模式使用工具。

先决条件

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

在 VS Code 中启用 MCP 支持

chat.mcp.access 设置控制哪些 MCP 服务器可以在 VS Code 中安装和运行

• all（默认）：允许所有 MCP 服务器
• registry：只允许来自注册表的 MCP 服务器
• none：不允许任何 MCP 服务器

集中管理 MCP 支持

你有两种选项可以集中管理组织中的 MCP 支持

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

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

添加 MCP 服务器

你可以在 VS Code 中通过多种方式添加 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 工具

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

   

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

   可选地，选择或取消选择你想要使用的工具。你可以在搜索框中输入以搜索工具。

   

   重要

   一个聊天请求一次最多可以启用 128 个工具。如果你选择了超过 128 个工具，请通过在工具选择器中取消选择一些工具来减少工具数量，或者确保启用了虚拟工具（github.copilot.chat.virtualTools.threshold）。

3. 在聊天输入框中输入提示，并注意工具如何根据需要自动调用。例如，安装 GitHub MCP 服务器并询问“列出我的 GitHub 问题”。

   

   提示

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

4. 当系统提示时，在确认之前仔细审查工具调用详细信息。

   注意

   MCP 工具可能在你的机器上本地运行，并可能执行修改文件或数据的操作。请务必确保你了解工具操作的含义。

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

   

5. 可选地，在运行工具之前验证和编辑工具输入参数。

   

清除缓存的 MCP 工具

当 VS Code 第一次启动 MCP 服务器时，它会发现服务器的功能和工具。然后你可以在代理模式下使用这些工具。VS Code 会缓存 MCP 服务器的工具列表。要清除缓存的工具，请在命令面板中使用MCP: 重置缓存工具命令。

使用 MCP 资源

MCP 服务器可以直接访问你可以用作聊天提示上下文的资源。例如，文件系统 MCP 服务器可以让你访问文件和目录，或者数据库 MCP 服务器可能提供对数据库表的访问。

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

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

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

   

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

MCP 工具可以作为其响应的一部分返回资源。你可以通过选择保存或将资源拖放到资源管理器视图来查看或保存这些资源到你的工作区。

使用 MCP 提示

MCP 服务器可以为常见任务提供预配置的提示，你可以通过斜杠命令在聊天中调用这些提示。要在聊天中调用 MCP 提示，请在聊天输入字段中输入 /，后跟提示名称，格式为 mcp.servername.promptname。

可选地，MCP 提示可能会要求你提供额外的输入参数。

将相关工具分组到工具集

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

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

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

管理已安装的 MCP 服务器

你可以对已安装的 MCP 服务器执行各种操作，例如启动或停止服务器、查看服务器日志、卸载服务器等。

要对 MCP 服务器执行这些操作，请使用以下任一选项

• 右键单击MCP 服务器 - 已安装部分中的服务器或选择齿轮图标

  

• 打开 mcp.json 配置文件并在编辑器中内联访问操作（代码透镜）

  

  使用MCP: 打开用户配置或MCP: 打开工作区文件夹配置命令访问 MCP 服务器配置。

• 从命令面板运行MCP: 列出服务器命令并选择一个服务器

  

自动启动 MCP 服务器

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

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

或者，从聊天视图手动重启 MCP 服务器，或从MCP 服务器列表中选择重启操作。

查找 MCP 服务器

MCP 仍然是一个相对较新的标准，生态系统正在快速发展。随着越来越多的开发人员采用 MCP，你可以期望看到越来越多的服务器和工具可用于与你的项目集成。

GitHub MCP 服务器注册表是一个很好的起点。你可以直接从 VS Code 中的扩展视图访问注册表。

MCP 的官方服务器仓库提供了官方和社区贡献的服务器，展示了 MCP 的多功能性。你可以探索用于各种功能的服务器，例如文件系统操作、数据库交互和 Web 服务。

VS Code 扩展还可以贡献 MCP 服务器并将其配置为扩展安装过程的一部分。检查 Visual Studio Marketplace 中提供 MCP 服务器支持的扩展。

MCP 服务器信任

MCP 服务器可以在你的机器上运行任意代码。只添加来自受信任来源的服务器，并在启动前审查发布者和服务器配置。阅读安全文档以了解在 VS Code 中使用 AI 的含义。

当你将 MCP 服务器添加到工作区或更改其配置时，你需要在启动服务器之前确认你信任该服务器及其功能。当你第一次启动服务器时，VS Code 会显示一个对话框以确认你信任该服务器。选择对话框中的 MCP 服务器链接以在单独的窗口中审查 MCP 服务器配置。

如果你不信任该服务器，它将不会启动，聊天请求将继续而不使用服务器提供的工具。

你可以通过从命令面板运行MCP: 重置信任命令来重置 MCP 服务器的信任。

跨设备同步 MCP 服务器

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

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

配置格式

MCP 服务器使用 JSON 文件 (mcp.json) 配置，该文件定义两个主要部分：服务器定义和敏感数据的可选输入变量。

MCP 服务器可以使用不同的传输方法连接。根据你的服务器如何通信选择适当的配置。

配置结构

配置文件有两个主要部分

• "servers": {} - 包含 MCP 服务器列表及其配置
• "inputs": [] - 用于敏感信息（如 API 密钥）的可选占位符

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

标准 I/O (stdio) 服务器

将此配置用于通过标准输入和输出流通信的服务器。这是本地运行的 MCP 服务器最常见的类型。

{
  "servers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

HTTP 和服务器发送事件 (SSE) 服务器

将此配置用于通过 HTTP 通信的服务器。VS Code 首先尝试 HTTP 流传输，如果不支持 HTTP，则回退到 SSE。

除了通过网络可用的服务器之外，VS Code 还可以连接到在 Unix 套接字或 Windows 命名管道上监听 HTTP 流量的 MCP 服务器，方法是在 Windows 上以 unix:///path/to/server.sock 或 pipe:///pipe/named-pipe 的形式指定套接字或管道路径。你可以通过使用 URL 片段指定子路径，例如 unix:///tmp/server.sock#/mcp/subpath。

{
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

敏感数据的输入变量

输入变量允许你定义配置值的占位符，避免直接在服务器配置中硬编码 API 密钥或密码等敏感信息。

当你使用 ${input:variable-id} 引用输入变量时，VS Code 会在服务器第一次启动时提示你输入值。然后该值会安全地存储以供后续使用。了解更多关于 VS Code 中的输入变量的信息。

输入变量属性

{
  "inputs": [
    {
      "type": "promptString",
      "id": "perplexity-key",
      "description": "Perplexity API Key",
      "password": true
    }
  ],
  "servers": {
    "perplexity": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "server-perplexity-ask"],
      "env": {
        "PERPLEXITY_API_KEY": "${input:perplexity-key}"
      }
    }
  }
}

服务器命名约定

定义 MCP 服务器时，请遵循以下服务器名称命名约定

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

故障排除和调试 MCP 服务器

MCP 输出日志

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

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

调试 MCP 服务器

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

• watch：一个文件 glob 模式，用于监视文件更改以重新启动 MCP 服务器。
• debug：使你能够使用 MCP 服务器设置调试器。目前，VS Code 支持调试 Node.js 和 Python MCP 服务器。

在 MCP 开发指南中了解更多关于MCP 开发模式的信息。

常见问题

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

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

使用 Docker 时 MCP 服务器未启动

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

我收到一条错误消息，指出“每个请求不能有超过 128 个工具。”

由于模型限制，一个聊天请求一次最多可以启用 128 个工具。如果你选择了超过 128 个工具，请通过在聊天视图中的工具选择器中取消选择一些工具或整个服务器来减少工具数量，或者确保启用了虚拟工具（github.copilot.chat.virtualTools.threshold）。

相关资源

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