MCP 配置參考

本文提供 MCP 伺服器配置檔案格式、相關命令以及 VS Code 中設定的參考。如需新增和管理 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 socket 或 Windows 具名管道上監聽 HTTP 流量的 MCP 伺服器，方法是指定 socket 或管道路徑，格式為 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 開發指南