MCP 配置参考

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

配置文件

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

配置结构

配置文件包含三个主要部分

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

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

• "sandbox": {}：一个可选对象，用于定义沙箱化服务器的文件系统和网络访问规则。请参阅 沙箱配置。仅适用于 macOS 和 Linux。

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

标准输入/输出 (stdio) 服务器

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

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

沙箱配置

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

要为服务器启用沙箱，请在其配置中设置 "sandboxEnabled": true。然后，定义一个顶级 sandbox 对象以指定文件系统和网络访问规则。sandbox 对象是 servers 和 inputs 的同级节点，其规则适用于所有沙箱化服务器。当沙箱化服务器需要当前规则未许可的访问权限时，请查看服务器输出中的错误消息，并相应地更新 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 还可以通过在 Windows 上指定 unix:///path/to/server.sock 或 pipe:///pipe/named-pipe 形式的套接字或管道路径，连接到监听 Unix 套接字或 Windows 命名管道上 HTTP 流量的 MCP 服务器。您可以使用 URL 片段指定子路径，例如 unix:///tmp/server.sock#/mcp/subpath。

oauth 对象支持以下属性

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

{
  "servers": {
    "slack": {
      "type": "http",
      "url": "https://mcp.slack.com/mcp",
      "oauth": {
        "clientId": "example-client-id"
      }
    }
  }
}

用于敏感数据的输入变量

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

当您使用 ${input:variable-id} 引用输入变量时，VS Code 会在服务器首次启动时提示您输入该值。然后，该值将被安全地存储以供后续使用。在 VS Code 中详细了解输入变量。

每个输入变量都有一个 type，决定了 VS Code 如何提示输入该值。支持以下输入类型

• promptString：打开一个输入框，要求用户输入自由文本值。
• pickString：显示一个选项列表供用户选择。
• command：运行命令并将结果用作输入值。

常用属性

promptString 属性

pickString 属性

command 属性

{
  "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 模式或 glob 模式数组，用于监视文件更改以重启 MCP 服务器。适用于所有服务器类型。
• debug：使您能够使用 MCP 服务器设置调试器。目前，VS Code 支持调试 Node.js 和 Python MCP 服务器。仅适用于 stdio 服务器。

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

服务器命名规范

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

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

命令

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

设置

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

相关资源

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