VSCode MCP 配置指南：从入门到精通 – wiki词典

作者： /

VSCode MCP 配置指南：从入门到精通

Visual Studio Code (VSCode) 的 Model Context Protocol (MCP) 是一项创新性的开放标准，它通过统一的接口，使 AI 模型（例如 GitHub Copilot Chat）能够发现并调用外部工具和服务。这极大地增强了 AI 在 VSCode 中的能力，使其能够执行文件操作、调用 API、执行任务等多种操作，从而提升您的编码效率。

I. 什么是 VSCode MCP (Model Context Protocol)?

MCP 是一种客户端-服务器架构的协议，旨在让 AI 模型能够与外部工具、应用程序和数据源进行交互。

  • MCP 客户端：例如 VSCode 中的 Copilot Chat，它连接到 MCP 服务器并代表 AI 模型请求操作。
  • MCP 服务器：提供一个或多个工具，这些工具通过明确定义的接口公开特定功能。这些服务器可以运行在本地，也可以部署在远程。
  • 协议定义：MCP 定义了客户端和服务器之间通信的消息格式，包括工具发现、调用和响应处理。

例如，一个文件系统 MCP 服务器可以提供读取、写入或搜索文件的工具；GitHub 的 MCP 服务器则可能提供列出仓库、创建拉取请求或管理问题的工具。

II. 入门配置：启用和添加 MCP 服务器

要开始使用 VSCode MCP，您需要进行一些基本的设置。

1. 前提条件

  • 安装最新版 Visual Studio Code：确保您的 VSCode 客户端是最新版本，因为 MCP 支持从 VSCode 1.102 版本开始全面可用。
  • 安装 GitHub Copilot 扩展并登录：MCP 功能通常与 GitHub Copilot 的 Agent 模式紧密集成。您需要安装 GitHub Copilot 扩展并登录您的账户（包括 Free、Business 或 Enterprise 计划）。

2. 启用 MCP 支持

在 VSCode 中，您需要启用 Agent 模式和 MCP 支持：

  1. 打开 VSCode 设置：
    • Windows/Linux: Ctrl + ,
    • macOS: Cmd + ,
  2. 在搜索栏中输入 chat.agent.enabled，并勾选以启用 “Chat: Agent Enabled”。
  3. 在搜索栏中输入 chat.mcp.enabled，并勾选以启用 “Chat: MCP Enabled”。

3. 添加 MCP 服务器

有多种方式可以将 MCP 服务器添加到 VSCode：

  • 从 GitHub MCP 服务器注册表安装 (推荐)
    这是最简单和推荐的方式，可以直接从 VSCode 内部安装精选的 MCP 服务器。

    1. 启用 MCP 服务器画廊：在 VSCode 设置中搜索 chat.mcp.gallery.enabled 并勾选。
    2. 打开扩展视图 (Ctrl + Shift + X)，在搜索框中输入 @mcp，或通过命令面板运行 MCP: Browse Servers 命令。VSCode 将从 GitHub MCP 服务器注册表检索服务器列表。
    3. 选择您想要安装的 MCP 服务器：
      • 安装到用户配置文件 (全局)：点击服务器旁边的 “Install” 按钮。这将使该服务器在所有 VSCode 工作区中可用。
      • 安装到当前工作区：右键点击服务器，选择 “Install in Workspace”。这将在当前工作区的 .vscode/mcp.json 文件中添加配置。

  • 通过命令面板添加

    1. 打开命令面板 (Ctrl + Shift + P 或 Cmd + Shift + P)。
    2. 运行 MCP: Add Server 命令。
    3. 根据提示提供服务器信息，并选择将其添加到工作区设置 (.vscode/mcp.json) 或用户设置 (mcp.json)。

  • 通过 .vscode/mcp.json 文件配置 (工作区级别)
    如果您希望为特定项目配置 MCP 服务器，可以在工作区根目录创建一个 .vscode/mcp.json 文件。

    1. 在您的项目根目录中创建一个名为 .vscode 的文件夹（如果不存在）。
    2. 在该文件夹内创建一个 mcp.json 文件。
    3. VSCode 会提供 IntelliSense 来帮助您配置服务器。您可以添加一个模板，例如：

    json
    {
    "servers": {
    "MyLocalServer": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-example"],
    "env": {
    "API_KEY": "${input:api-key}"
    },
    "inputs": [
    {
    "type": "promptString",
    "id": "api-key",
    "description": "API Key",
    "password": true
    }
    ]
    }
    }
    }
    * 配置格式说明：
    * servers：包含一个或多个 MCP 服务器的定义。
    * MyLocalServer：服务器的名称。
    * type：连接类型，例如 stdio (本地标准输入/输出)、http (流式 HTTP)。
    * command：启动服务器可执行文件的命令。
    * args：传递给命令的参数数组。
    * env：服务器的环境变量。
    * inputs：用于敏感数据（如 API 密钥）的可选输入变量。

  • 通过用户设置配置 (全局级别)
    如果您希望某个 MCP 服务器在所有工作区中都可用，可以将其配置添加到用户配置文件中。

    1. 打开命令面板 (Ctrl + Shift + P 或 Cmd + Shift + P)。
    2. 运行 MCP: Open User Configuration 命令，这将打开用户配置文件中的 mcp.json 文件。
    3. 手动添加服务器配置，格式与工作区级别的 mcp.json 类似。

  • 自动发现
    VSCode 可以自动发现您在其他工具（如 Claude Desktop）中定义的 MCP 服务器。

    1. 在 VSCode 设置中搜索 chat.mcp.discovery.enabled 并勾选以启用自动发现功能。

III. 进阶使用：管理和利用 MCP 工具

配置好 MCP 服务器后，您可以开始管理它们并在 AI Agent 模式下使用其提供的工具。

1. 管理 MCP 服务器

  • 在扩展视图中管理：打开扩展视图 (Ctrl + Shift + X)，在 @mcp 搜索结果中，您可以右键点击已安装的 MCP 服务器或选择齿轮图标来执行管理操作。
  • 使用命令面板：运行 MCP: List Servers 命令可以查看所有已配置的 MCP 服务器列表。
  • 操作服务器：您可以从这些视图中启动、停止或重启服务器，并查看服务器配置和日志以进行故障排除。

2. 在 Agent 模式中使用 MCP 工具

一旦配置了 MCP 服务器，您就可以在 Copilot 的 Agent 模式中使用其工具：

  1. 打开 Chat 视图 (Windows/Linux: Ctrl + Alt + I, Mac: ⌃⌘I)。
  2. 从下拉菜单中选择 “Agent” 模式。
  3. 点击 “Tools” 按钮，查看所有连接的 MCP 服务器提供的可用工具列表。
  4. 您可以选择或取消选择特定的工具。

  5. 在聊天输入框中输入您的提示，AI 将根据需要自动调用工具。默认情况下，当工具被调用时，您需要确认操作才能运行。这是一个安全措施，因为工具可能在本地机器上运行并修改文件或数据。

    安全提示：本地 MCP 服务器可以运行任意代码。请务必只添加来自受信任来源的服务器，并在启动前仔细审查发布者和服务器配置。VSCode 在首次启动 MCP 服务器时会提示您确认是否信任该服务器。

3. 同步 MCP 服务器配置

如果您在用户配置文件中配置了 MCP 服务器，可以使用 VSCode 的 “设置同步” 功能在不同设备间同步这些配置。

  1. 打开命令面板。
  2. 运行 Settings Sync: Configure 命令。
  3. 确保 MCP 服务器包含在同步配置列表中，以在所有设备上保持一致的开发环境。

通过掌握 Model Context Protocol (MCP) 的配置，您将能够更高效、更智能地在 VSCode 中进行开发，尤其是在利用 AI 辅助编程和管理复杂项目时。

滚动至顶部