MCP 配置参考

本文档提供了 VS Code 中 MCP 服务器配置文件格式、相关命令和设置的参考。有关添加和管理 MCP 服务器的信息，请参阅 添加和管理 MCP 服务器。

配置文件

MCP 服务器配置存储在 mcp.json JSON 文件中。该文件可以位于您的工作区 (.vscode/mcp.json) 或您的 用户配置文件 中。VS Code 为该配置文件提供了 IntelliSense（智能感知）支持。

配置结构

配置文件包含两个主要部分：

• "servers": {}：一个将服务器名称映射到其配置的对象。每个键都是服务器名称，值是服务器配置对象。根据服务器类型的不同，需要填写的字段也不同。

• "inputs": []：一个可选数组，用于定义 API 密钥等敏感信息的输入变量。

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

标准 I/O (stdio) 服务器

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

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

沙盒配置

您可以为本地运行的 stdio MCP 服务器启用沙盒功能，以限制它们对文件系统和网络的访问。沙盒服务器只能访问您明确允许的文件系统路径和网络域。沙盒功能仅在 macOS 和 Linux 上可用。

要为服务器启用沙盒，请在其配置中设置 "sandboxEnabled": true。然后，使用 sandbox 对象定义文件系统和网络访问规则。当沙盒服务器需要当前规则未允许的访问权限时，请检查服务器输出中的错误消息，并相应地更新 sandbox 配置。

sandbox 对象支持以下属性

您可以在文件系统路径值中使用 预定义变量，例如 ${workspaceFolder}。

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

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

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

除了可通过网络访问的服务器外，VS Code 还可以连接到在 Unix 套接字或 Windows 命名管道上监听 HTTP 流量的 MCP 服务器。通过指定套接字或管道路径（格式为 unix:///path/to/server.sock 或 Windows 上的 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}"
      }
    }
  }
}

开发模式

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

• watch：一个文件 glob 模式，用于监视文件更改并在发生更改时重启 MCP 服务器。
• debug：允许您为 MCP 服务器设置调试器。目前，VS Code 支持调试 Node.js 和 Python MCP 服务器。

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

服务器命名规范

定义 MCP 服务器时，请遵循以下命名规范：

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

命令

下表列出了命令面板中可用的 MCP 相关命令（⇧⌘P (Windows, Linux Ctrl+Shift+P)）。

设置

有关 VS Code AI 设置的完整列表，请参阅 AI 设置参考。以下设置是 MCP 服务器特有的。

相关资源

• 添加和管理 MCP 服务器
• 模型上下文协议文档
• MCP 开发指南