CloakBrowser MCP

cloakbrowser-mcp

cloakbrowser-mcp は、上流のツールを変更せず、CloakBrowser Chromium を使用し、本番環境ですぐに使える npm、Docker、Streamable HTTP パッケージを提供する、Playwright MCP 互換のブラウザー自動化サーバーです。上流の @playwright/mcp を標準のツールインターフェースとして実行し、そのランタイムの接続先を CloakBrowser に設定します。

30 秒デモ

npx -y cloakbrowser-mcp@latest を実行して Claude Desktop または Codex CLI に接続し、Web 調査、日常の自動化、テストを自然な言葉で依頼して、実際のブラウザーの結果を確認します。

ドキュメント：swimmwatch.github.io/cloakbrowser-mcp · 比較 · レシピ

次のような用途に適しています。

• CloakBrowser を利用する Playwright MCP ブラウザー自動化。
• 変更されていない上流のブラウザーツールと、2 つのローカルなイントロスペクションツール。
• stdio または Streamable HTTP を介した npm または Docker によるインストール。
• chromium.connectOverCDP() を介して CDP 対応クライアントから利用できる、オプトインでセッション単位の管理対象 CDP アクセス。
• 永続的なブラウザープロファイル、検証済みのコンテキストオプション、Chrome 拡張機能の読み込み。
• 地域別 QA のための GeoIP 対応プロキシ照合。
• 操作に敏感なフロー向けの、人間らしいマウス、キーボード、スクロールの動作。

クロスプラットフォームのチェックでは、テストに記載された Node.js バージョンを対象に、Linux x64/arm64、macOS arm64/x64、Windows x64 で npm を検証します。Docker イメージは linux/amd64 および linux/arm64 向けにビルドされ、スモークテストが実施されます。

標準の上流 Playwright MCP と CloakBrowser MCP のどちらがデプロイ環境に適しているかを判断する際は、@playwright/mcp と cloakbrowser-mcp の比較をご覧ください。レシピでは、永続的なログインプロファイル、Chrome 拡張機能、リバースプロキシ、地域別 QA、クライアント接続、CI スモークテストに焦点を当てたセットアップ方法を紹介しています。

npm でインストール

npx -y cloakbrowser-mcp@latest

Node.js 22.x 系では 22.13 以降、または Node.js 24 以降が必要です。クライアントの接続を設定する前に、診断を実行してください。

npx -y cloakbrowser-mcp@latest doctor

stdio ではなく Streamable HTTP を使う場合：

npx -y cloakbrowser-mcp@latest --transport streamable-http --http-port 3000

すべてのフラグについては、生成された CLI リファレンスをご覧ください。

Docker でインストール

docker run --rm -i \
  -v "$PWD/artifacts:/data" \
  swimmwatch/cloakbrowser-mcp:latest

Streamable HTTP の場合：

docker run --rm -p 127.0.0.1:3000:3000 \
  -v "$PWD/artifacts:/data" \
  swimmwatch/cloakbrowser-mcp:latest \
  --transport streamable-http --http-host 0.0.0.0 --http-port 3000

Docker イメージは成果物を /data に書き込み、linux/amd64 および linux/arm64 向けに公開されています。Chromium のサンドボックスを利用できないことが多いコンテナ化ランタイムとの互換性のため、デフォルトで CLOAK_PLAYWRIGHT_MCP_NO_SANDBOX=true に設定されています。ホストおよびコンテナランタイムが Chromium のサンドボックスに対応している場合は、CLOAK_PLAYWRIGHT_MCP_NO_SANDBOX=false を設定してください。信頼できないページを扱う場合は、コンテナのネットワークアクセスとマウントするホストディレクトリを厳密に制限してください。同じタグは ghcr.io/swimmwatch/cloakbrowser-mcp からも利用できます。永続プロファイル、拡張機能のマウント、HTTPS、スモークテストの例についてはDockerをご覧ください。また、Streamable HTTP のデプロイ方法を詳しく確認するには、リバースプロキシのレシピをご利用ください。

MCP クライアントに追加

Codex CLI

codex mcp add cloakbrowser -- npx -y cloakbrowser-mcp@latest

Claude Code

claude mcp add --transport stdio cloakbrowser -- npx -y cloakbrowser-mcp@latest

VS Code の GitHub Copilot

{
  "servers": {
    "cloakbrowser": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "cloakbrowser-mcp@latest"]
    }
  }
}

Claude Desktop、Cursor、Cline、Windsurf、Warp、その他の mcpServers クライアント

クライアントの MCP JSON 設定に、次のサーバーエントリを追加します。

{
  "mcpServers": {
    "cloakbrowser": {
      "command": "npx",
      "args": ["-y", "cloakbrowser-mcp@latest"]
    }
  }
}

Docker を使用した stdio

{
  "mcpServers": {
    "cloakbrowser": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/tmp/cloakbrowser-artifacts:/data",
        "swimmwatch/cloakbrowser-mcp:latest"
      ]
    }
  }
}

起動済みの Streamable HTTP サーバー

npx -y cloakbrowser-mcp@latest --transport streamable-http --http-port 3000
codex mcp add cloakbrowser --url http://127.0.0.1:3000/mcp
claude mcp add --transport http cloakbrowser http://127.0.0.1:3000/mcp

コードアシスタント向けプロンプト

MCP 設定を編集できる Codex、Claude Code、Copilot、Cursor、Cline、Windsurf、または同様のコーディングアシスタントに貼り付けてください。

Install the CloakBrowser MCP server for this workspace. Name it "cloakbrowser".
Prefer stdio with command "npx" and args ["-y", "cloakbrowser-mcp@latest"].
If this client uses VS Code mcp.json, add it under "servers" with type "stdio".
If this client uses Claude/Cursor/Cline/Windsurf/Warp-style config, add it under
"mcpServers" with the same command and args. Do not add secrets.

その他の例ははじめにをご覧ください。Claude DesktopとCodex CLI向けの専用レシピもあります。

設定

ブラウザー、成果物、タイムアウト、ネットワーク、ツール機能の設定には、上流の PLAYWRIGHT_MCP_* 変数を使用します。Cloak 固有のブリッジ切り替えには CLOAK_PLAYWRIGHT_MCP_* を使用します。起動前に --release-channel preview または CLOAK_PLAYWRIGHT_MCP_RELEASE_CHANNEL=preview を指定して Pro Preview ブラウザービルドを選択してください。デフォルトは stable です。

共通の変数一覧は設定に掲載されています。このページでは、永続プロファイル、検証済みのコンテキストオプション、Chrome 拡張機能、Streamable HTTP メタデータ、HTTPS／認証オプションについても説明しています。地域別のプロキシ動作についてはGeoIP プロキシの照合、操作のリアリティについては人間らしい入力の動作、タスク別の設定についてはレシピをご覧ください。

バージョン互換性

cloakbrowser-mcp	@playwright/mcp	CloakBrowser	Node.js	プラットフォーム
1.15.1	^0.0.83	^0.6.3	`^22.13.0
1.15.0	^0.0.83	^0.6.3	`^22.13.0
1.14.1	^0.0.82	^0.5.10	`^22.13.0
1.14.0	^0.0.82	^0.5.10	`^22.13.0
1.13.0	^0.0.80	^0.5.10	`^22.13.0
1.12.0	^0.0.79	^0.5.7	`^22.13.0
1.11.0	^0.0.79	^0.5.6	`^22.13.0
1.10.0	^0.0.78	^0.5.3	`^22.13.0
1.9.0	^0.0.78	^0.5.1	`^22.13.0
1.8.0	^0.0.78	^0.4.10	`^22.13.0
1.7.0	^0.0.77	^0.4.8	>=22.12	Linux x64/arm64、macOS arm64/x64、Windows x64 の npm；Docker linux/amd64、linux/arm64
1.6.1	^0.0.77	^0.4.7	>=22.12	Linux x64/arm64、macOS arm64/x64、Windows x64 の npm；Docker linux/amd64、linux/arm64
1.6.0	^0.0.77	^0.4.7	>=22.12	Linux x64/arm64、macOS arm64/x64、Windows x64 の npm；Docker linux/amd64、linux/arm64
1.5.0	^0.0.76	^0.4.3	>=22.12	Linux x64/arm64、macOS arm64/x64、Windows x64 の npm；Docker linux/amd64、linux/arm64
1.4.0	^0.0.76	^0.3.32	>=22.12	Linux x64/arm64、macOS arm64/x64、Windows x64 の npm；Docker linux/amd64、linux/arm64
1.3.0	^0.0.75	^0.3.31	>=20	Docker linux/amd64、ローカルの Node.js
1.2.7	^0.0.75	^0.3.30	>=20	Docker linux/amd64、ローカルの Node.js
1.2.6	^0.0.75	^0.3.30	>=20	Docker linux/amd64、ローカルの Node.js
1.2.5	^0.0.75	^0.3.30	>=20	Docker linux/amd64、ローカルの Node.js
1.2.3	^0.0.75	^0.3.30	>=20	Docker linux/amd64、ローカルの Node.js
1.2.2	^0.0.75	^0.3.30	>=20	Docker linux/amd64、ローカルの Node.js
1.2.1	^0.0.75	^0.3.30	>=20	Docker linux/amd64、ローカルの Node.js
1.2.0	^0.0.75	^0.3.30	>=20	Docker linux/amd64、ローカルの Node.js
1.1.0	^0.0.75	^0.3.30	>=20	Docker linux/amd64、ローカルの Node.js
1.0.2	^0.0.75	^0.3.30	>=20	Docker linux/amd64、ローカルの Node.js
1.0.1	^0.0.75	^0.3.30	>=20	Docker linux/amd64、ローカルの Node.js
1.0.0	^0.0.75	^0.3.30	>=20	Docker linux/amd64、ローカルの Node.js
保守対象の互換性一覧については、バージョン互換性を参照してください。

ツール

上流の Playwright MCP ツール一覧が正式な一覧です。このプロジェクトでは、上流のブラウザーのスキーマをソースコードで再実装したり、再ドキュメント化したりしていません。

ローカルツール：

• cloakbrowser_binary_info は、CloakBrowser のパッケージ、プラットフォーム、キャッシュ、解決済みのバイナリ情報を返します。
• cloakbrowser_bridge_info は、ブリッジのメタデータ、上流のパッケージとバージョン、ローカルツール名を返します。

開発

npm install
npm run build
npm test
npm run docker:build
npm run docker:smoke
npm run server:validate
npm run bridge:compare -- cloakbrowser-mcp:dev --report bridge-parity-report.json

ドキュメントはdocs/getting-started.mdから始まります。コントリビューター向けの資料はdocs/contributor-guide.mdにまとめられています。

ローカルの Allure レポートと、プルリクエストからリンクされた CI マトリックスの統合レポートについては、テストレポートを参照してください。