MCP構成リファレンス

この記事では、VS CodeにおけるMCPサーバー構成ファイルの形式、関連コマンド、および設定のリファレンスを提供します。MCPサーバーの追加および管理に関する詳細については、「MCPサーバーの追加と管理」を参照してください。

構成ファイル

MCPサーバーの構成は、mcp.jsonというJSONファイルに保存されます。このファイルはワークスペース（.vscode/mcp.json）またはユーザープロファイル内に配置できます。VS Codeは、この構成ファイルに対してIntelliSenseを提供します。

構成構造

構成ファイルには主に2つのセクションがあります。

• "servers": {}: サーバー名と構成をマッピングするオブジェクトです。各キーはサーバー名であり、値はサーバー構成オブジェクトです。サーバーのタイプに応じて、異なるフィールドが必要になります。

• "inputs": []: APIキーなどの機密情報のための入力変数定義を格納するオプションの配列です。

サーバー構成内では、ワークスペースフォルダー（${workspaceFolder}）を参照するなど、定義済みの変数を使用できます。

標準入出力（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およびServer-Sent Events (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サーバーの開発モードを有効にできます。これは、2つのプロパティを持つオブジェクトです。

• watch: ファイルの変更を監視し、MCPサーバーを再起動するためのファイルグロブパターン。
• debug: MCPサーバーのデバッガーをセットアップできるようにします。現在、VS CodeはNode.jsおよびPythonのMCPサーバーのデバッグをサポートしています。

MCP開発ガイドのMCP開発モードについての詳細をご覧ください。

サーバー名の命名規則

MCPサーバーを定義する際は、サーバー名に対して以下の命名規則に従ってください。

• "uiTesting"や"githubIntegration"のように、キャメルケースを使用する。
• 空白や特殊文字の使用は避ける。
• 競合を避けるため、各サーバーに一意の名前を使用する。
• "github"や"database"のように、サーバーの機能やブランドを反映した説明的な名前を使用する。

コマンド

以下の表は、コマンドパレット（⇧⌘P (Windows, Linux Ctrl+Shift+P)）で使用可能なMCP関連コマンドの一覧です。

設定

VS Code AI設定の完全なリストについては、「AI設定リファレンス」を参照してください。以下の設定はMCPサーバーに固有のものです。

関連リソース

• MCPサーバーの追加と管理
• Model Context Protocol ドキュメント
• MCP 開発ガイド