MCP 設定參考

本文提供 VS Code 中 MCP 伺服器設定檔格式、相關指令與設定的參考。有關新增及管理 MCP 伺服器的資訊，請參閱新增與管理 MCP 伺服器。

設定檔

MCP 伺服器設定儲存在 mcp.json JSON 檔案中。此檔案可以位於您的工作區 (.vscode/mcp.json) 或您的使用者設定檔中。VS Code 為此設定檔提供 IntelliSense 支援。

設定結構

設定檔包含三個主要區塊：

• "servers": {}：一個將伺服器名稱對應至其設定的物件。每個鍵（key）為伺服器名稱，值（value）則為伺服器設定物件。根據伺服器類型的不同，需要提供不同的欄位。

• "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 Stream 傳輸，若不支援則會降級使用 SSE。

除了網路上可用的伺服器外，VS Code 亦可透過指定 Socket 或 Pipe 路徑（格式為 unix:///path/to/server.sock 或 Windows 上的 pipe:///pipe/named-pipe），連接至監聽 Unix Socket 或 Windows Named Pipe 的 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"
      }
    }
  }
}

敏感資料的輸入變數

輸入變數可讓您為設定值定義預留位置 (placeholder)，避免將 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"

命令

下表列出了命令選擇區 (Command Palette) (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中可用的 MCP 相關指令。

設定

有關 VS Code AI 設定的完整清單，請參閱AI 設定參考。下列設定為 MCP 伺服器專屬。

相關資源

• 新增和管理 MCP 伺服器
• 模型上下文協定文件
• MCP 開發指南