Docker MCP Toolkit & Gateway (Official)

Docker MCP Toolkit & Gateway (Official) とは？

Docker MCP Toolkit & Gateway (Official) は Docker 公式の docker mcp スタックです。docker mcp CLI プラグインと MCP Gateway で構成され、Docker MCP Catalog の MCP サーバーを分離されたコンテナとして実行し、Claude、Cursor、VS Code などのクライアントに 1 つのエンドポイントで提供します。

オープンソースの docker/mcp-gateway リポジトリ（MIT ライセンス）には、MCP Toolkit を支える CLI プラグインが含まれています。MCP Catalog（hub.docker.com/mcp、OCI イメージ mcp/docker-mcp-catalog）はコンテナ化されたサーバーの一覧、MCP Gateway はそれらを実行して呼び出しをルーティングする役割、MCP Toolkit はその上に載る Docker Desktop の UI です。

Docker MCP Toolkit & Gateway (Official) の使い方

前提条件：MCP Toolkit を有効にした Docker Desktop（Settings → Beta features → Enable Docker MCP Toolkit → Apply）。Docker のドキュメントは Docker Desktop 4.62 以降の画面と docker mcp コマンドを対象にしています。

Docker CE、WSL2、コンテナ内では、README に従って次を実行します。

export DOCKER_MCP_IN_CONTAINER=1
docker mcp feature enable profiles

1. カタログからサーバーを選ぶ

docker mcp catalog pull mcp/docker-mcp-catalog
docker mcp catalog server ls mcp/docker-mcp-catalog

表示される名前（github-official など）が catalog:// 参照で使う ID です。

2. プロファイルを作成する（クライアントが接続するサーバーの名前付きセット）

docker mcp profile create --name web-dev
docker mcp profile server add web-dev \
  --server catalog://mcp/docker-mcp-catalog/github-official \
  --server catalog://mcp/docker-mcp-catalog/playwright

3. ゲートウェイを起動する

docker mcp gateway run --profile web-dev

--profile を省略すると default プロファイルが使われます。通常はクライアントがこのコマンドを stdio で自動起動します。

4. クライアントを接続する。 docker mcp client connect で指定できる名前には claude-code、claude-desktop、cursor、vscode、codex、gemini、zed、cline、continue、goose、kiro、lmstudio、opencode があります。

docker mcp client ls
docker mcp client connect <client> --profile web-dev

Claude Code

docker mcp client connect claude-code --profile web-dev --global

その後 claude mcp list で MCP_DOCKER が接続済みと表示されるはずです。

Claude Desktop

Docker Desktop で MCP Toolkit → Clients を開き、Claude Desktop の横の Connect を選んでから Claude Desktop を再起動します。Docker のドキュメントにある手動設定：

{
  "mcpServers": {
    "MCP_DOCKER": {
      "command": "docker",
      "args": ["mcp", "gateway", "run", "--profile", "web-dev"]
    }
  }
}

Cursor

docker mcp client connect cursor --profile web-dev

Cursor Settings → Tools & MCP に MCP_DOCKER があることを確認します。

VS Code

プロジェクトフォルダで実行します（ユーザー固有の .vscode/mcp.json が作成されます）。

docker mcp client connect vscode --profile web-dev
echo ".vscode/mcp.json" >> .gitignore

Codex

docker mcp client connect codex --profile web-dev
codex mcp list

MCP_DOCKER が「enabled」状態で表示されるはずです。

Docker MCP Toolkit & Gateway (Official) の主な機能

• Docker 公式プロジェクト、MIT ライセンス。Docker Desktop に同梱され、単体でも利用可能
• 各サーバーは専用コンテナで動作し、デフォルトで CPU 1 個・メモリ 2 GB に制限。許可しない限りホストのファイルシステムにはアクセスできない
• Docker MCP Catalog の mcp/ 配下のイメージは Docker がビルド・署名し、SBOM 付き。署名検証はデフォルトで有効
• シークレットはクライアントの環境変数ではなく Docker Desktop のストア（OS のキーチェーン）から取得され、宣言したサーバーだけが利用できる
• GitHub、Notion、Linear などのサーバー向けに OAuth フローを内蔵
• プロファイルはサーバーごとの設定とツール許可リストに対応し、OCI レジストリやエクスポートしたファイルで共有可能
• デフォルトは stdio。bearer token で保護された sse と streaming の HTTP トランスポートにも対応
• docker/mcp-gateway イメージとしても公開され、Docker Compose や CI で利用可能

Docker MCP Toolkit & Gateway (Official) のツール

ゲートウェイはプロファイル内の各サーバーのツールを公開します。さらに Dynamic MCP（実験的機能）がいくつかの管理ツールを追加します。

• 検索： mcp-find は名前や説明でカタログを検索します。
• セッション管理： mcp-add と mcp-remove は現在のセッションにサーバーを追加・削除し、mcp-config-set はサーバーを設定します。この方法で追加したサーバーはプロファイルに保存されません。
• 実行： mcp-exec は名前を指定してツールを実行し、code-mode は複数サーバーのツールを JavaScript ツールにまとめます。Docker によると code mode はまだ一般的な利用には向きません。

ツール一覧を固定したい場合は docker mcp feature disable dynamic-tools で無効化できます。プロファイル内のツールを絞り込むには許可リストを使います。

docker mcp profile tools web-dev --disable-all github-official
docker mcp profile tools web-dev --enable github-official.list_issues

Docker MCP Toolkit & Gateway (Official) のユースケース

• コミュニティ製 MCP サーバーを、ホスト上の npx や uvx ではなく分離されたコンテナで実行する。
• エージェントに必要なツールをその場で探させる：「What MCP servers can I use for working with SQL databases?」、続けて「Add the postgres mcp server.」
• Docker Compose や CI のエージェントに --servers でゲートウェイを提供する（Docker Desktop 不要）。
• エージェントを社内カタログに限定する：docker mcp gateway run --catalog <oci-reference>。

Docker MCP Toolkit & Gateway (Official) と代替ツールの比較

「docker mcp」という言葉には、Docker 自体を操作するサーバーも含まれますが、これは別の用途です。mcp-server-docker（ckreiling、コミュニティ製）は自然言語で Docker を管理し、コンテナの構成、稼働中コンテナのデバッグ、ボリューム管理を行います。docker-mcp（QuantGeekDev、コミュニティ製）はコンテナの作成、Compose スタックのデプロイ、コンテナログの取得ができます。Docker を操作したいならこれらを、クライアント向けに多数の MCP サーバーを安全に動かしたいなら公式の Docker MCP Toolkit を使いましょう。詳しい手順は Docker MCP Gateway セットアップガイドを参照してください。

Docker MCP Toolkit & Gateway (Official) のトラブルシューティング

• クライアントにツールが表示されない： docker mcp gateway run --verbose --dry-run を実行します。有効なサーバー、取得済みイメージ、ツール数が表示され、サーバー名の誤りや設定・シークレットの不足を見つけられます。
• ツールを 1 つだけテストする： docker mcp tools call <tool-name> [arguments...] に --verbose を付けて実行します。
• デーモンは動いているのに「Docker Desktop is not running」と出る： export DOCKER_MCP_IN_CONTAINER=1 を設定します（WSL2、Docker CE、コンテナ環境）。
• 「unsupported dialect」スキーマエラー： ゲートウェイを更新します。現行版は draft-04/06/07 のツールスキーマを JSON Schema 2020-12 に変換します。
• チュートリアルの手順が画面と合わない： Docker のドキュメントは Docker Desktop 4.62 以降が対象です。それより古いバージョンは Toolkit の UI が異なります。