Chrome Control MCP

AIアシスタントのための、可視性の高い精密なChrome制御。ローカル設計。

クイックスタート · ツールカタログ · アーキテクチャ · セキュリティ · 検証

アクティブな自動化は可視のままです。ピンク色のフレーム、AI CONTROLバッジ、パルスするエージェントカーソルが、アシスタントがChromeを制御しているときに表示されます。モデル向けのスクリーンショットでは、このオーバーレイはデフォルトで非表示になります。ドキュメントのキャプチャではオプトインできます。

このプロジェクトの目的

全43個のMCPツールは厳密なJSON Schemaを使用します。長時間実行されるMCPプロセスは、Chromeが通常のユーザー制御ブラウザのままである間、セッションと要素参照の状態を保持します。

Related MCP server: Chrome MCP Server

動作の様子

両方の画像は、モックアップではなく、ライブ拡張機能からの直接のbrowser_screenshot結果です。

テストに関する謝辞: InflectraのUI Test Automation Playground とオープンソースリポジトリは、 焦点を絞った実用的なブラウザ操作シナリオを提供します。このプロジェクトの完全なMCP-to-Chromeパスのテストに非常に役立ちました。

クイックスタート

1. ビルド要件のインストール

• Windows 10/11 x64、Linux x64、またはmacOS

• Google Chrome 116+

• CMake 3.25+

• CoreおよびTestコンポーネントを含むQt 6.5+

• C++20コンパイラ: Visual Studio 2022、GCC、またはClang

• Node.js 20.19+

2. ビルドとテスト

npm ci
npm run build

デフォルトの出力:

PowerShellユーザーは、代わりに./scripts/build.ps1 -Configuration Releaseを実行できます。どちらのパスも警告をエラーとして扱い、すべてのネイティブおよび拡張機能のユニットスイートを実行します。

3. Chromeの準備

npm run extension -- install

chrome://extensionsを開き、デベロッパーモードを有効にして、パッケージ化されていない拡張機能を読み込むを選択し、コマンドで出力されたフォルダーを選択します。Chromeでは、パッケージ化されていない拡張機能にはこの手動の手順が1つ必要です。

署名キー、パッケージ化された拡張機能、ストアアカウント、管理者アクセス、エンタープライズポリシーは不要です。manifest.jsonの公開keyは、パッケージ化されていない拡張機能IDを固定するだけです。ソフトウェアに署名することはできません。

4. アシスタントの接続

絶対実行可能ファイルパスを使用します。

# Windows
codex mcp add chrome-control -- "C:\absolute\path\chrome_control_mcp.exe"

# Linux / macOS
codex mcp add chrome-control -- /absolute/path/chrome_control_mcp

Claude Codeは同じ実行可能ファイルを使用します:

claude mcp add --scope local chrome-control -- /absolute/path/chrome_control_mcp

トランスポートは、stdio上の改行区切りのJSON-RPCです。サーバーはTCPリスナーを開きません。

アーキテクチャ

flowchart LR
    A[AI assistant] -->|MCP over stdio| B[chrome_control_mcp]
    B -->|Windows named pipe<br/>Linux/macOS Unix socket| C[Native-host relay]
    C -->|Chrome native messaging| D[Unpacked MV3 extension]
    D -->|Chrome DevTools Protocol| E[Active Chrome tab]

1つの実行可能ファイルがMCPサーバーとネイティブホストリレーの役割を提供します。ブラウザ制御は、呼び出し可能なツール、画像結果、強化されたIPC、永続的なセッション状態が必要なため、MCPに属します。スキルはワークフローを追加できますが、サーバーを置き換えることはありません。

セキュリティモデル

完全な制御は強力です。Chrome Control MCPは拡張機能のオリジンを固定し、IPCを制限して検証し、同じユーザー/同じ実行可能ファイルのリレーを認証し、古い要素参照とスクリーンショット座標を拒否し、主要なペイロードを制限し、厳密なスキーマを公開します。

Windowsは、現在のユーザーのACLで保護された名前付きパイプを使用します。LinuxとmacOSは、プライベートランタイムディレクトリ内のモード0600のUnixソケットと、オペレーティングシステムのピア資格情報を使用します。

検査専用の使用の場合:

CHROME_CONTROL_MCP_SECURITY_PROFILE=read_only
CHROME_CONTROL_MCP_REDACT_SENSITIVE_OUTPUT=true

読み取り専用プロファイルは10個のツールを公開し、隠れた変更呼び出しを独立して拒否します。

検証

ローカルのWindowsとLinuxのゲートは現在以下をカバーしています:

• MSVC、GCC、Clangによる9/9のネイティブおよび拡張スイート

• 警告をエラーとして扱うことに加えて、clang-tidyと網羅的なcppcheck

• 個別のASan+UBSanおよびTSan実行

• 全履歴のGitleaksスキャンとnpm依存関係監査

• Windows上の実際のChromeを通した43/43のライブMCPツール

• 公開UI Playgroundのナビゲーション、スナップショット、タイピング、クリック、PNGキャプチャ

• 元に戻せるネイティブホストのインストール/ステータス/アンインストールライフサイクル

GitHub Actionsは、直接プッシュのたびにWindows、Linux、macOSでビルドとテストを実行します。

npm run smoke
npm run smoke:read-only
node tests/e2e/full_browser_e2e.mjs

PowerShellライブ公開サイトチェック:

./scripts/live_browser_verify.ps1 -Site http://uitestingplayground.com/

正確な証拠と主張の境界を参照。

プロジェクトID

現在のユーザーのネイティブホストをnpm run extension -- uninstallで登録解除し、廃止するときにchrome://extensionsからパッケージ化されていない拡張機能を手動で削除します。

ライセンス

MIT Licenseの下でリリースされています。Copyright © 2026 Randy Northrup.

Chrome Control MCP

AIアシスタントのための可視で精密なChrome制御。ローカル設計。

クイックスタート · ツールカタログ · アーキテクチャ · セキュリティ · 検証

アクティブな自動化は可視のままです。ピンクのフレーム、AI CONTROLバッジ、パルスするエージェントカーソルが、アシスタントがChromeを制御していることを示します。モデル向けのスクリーンショットでは、このオーバーレイはデフォルトで非表示になります。ドキュメントのキャプチャではオプトインできます。

このプロジェクトの理由

全43個のMCPツールは厳密なJSON Schemaを使用します。長時間実行されるMCPプロセスは、Chromeが通常のユーザー制御ブラウザのままである間、セッションと要素参照の状態を保持します。

動作の様子

両方の画像は、モックアップではなく、ライブ拡張機能からの直接のbrowser_screenshot結果です。

テストへの謝辞: InflectraのUI Test Automation Playground とオープンソースリポジトリは、 焦点を絞った実用的なブラウザ操作シナリオを提供します。このプロジェクトの完全なMCP-to-Chromeパスのテストに非常に役立ちました。

クイックスタート

1. ビルド要件のインストール

• Windows 10/11 x64、Linux x64、またはmacOS

• Google Chrome 116+

• CMake 3.25+

• Qt 6.5+（CoreおよびTestコンポーネントを含む）

• C++20コンパイラ: Visual Studio 2022、GCC、またはClang

• Node.js 20.19+

2. ビルドとテスト

npm ci
npm run build

デフォルトの出力:

PowerShellユーザーは、代わりに./scripts/build.ps1 -Configuration Releaseを実行できます。どちらのパスも警告をエラーとして扱い、すべてのネイティブおよび拡張ユニットスイートを実行します。

3. Chromeの準備

npm run extension -- install

chrome://extensionsを開き、デベロッパーモードを有効にして、パッケージ化されていない拡張機能を読み込むを選択し、コマンドが出力したフォルダーを選択します。Chromeでは、パッケージ化されていない拡張機能にはこの手動の手順が1つ必要です。

署名キー、パッケージ化された拡張機能、ストアアカウント、管理者権限、エンタープライズポリシーは不要です。manifest.jsonの公開keyは、パッケージ化されていない拡張機能IDを固定するだけです。ソフトウェアに署名することはできません。

4. アシスタントの接続

絶対パスの実行可能ファイルを使用します。

# Windows
codex mcp add chrome-control -- "C:\absolute\path\chrome_control_mcp.exe"

# Linux / macOS
codex mcp add chrome-control -- /absolute/path/chrome_control_mcp

Claude Codeは同じ実行可能ファイルを使用します:

claude mcp add --scope local chrome-control -- /absolute/path/chrome_control_mcp

トランスポートは、stdio上の改行区切りのJSON-RPCです。サーバーはTCPリスナーを開きません。

アーキテクチャ

flowchart LR
    A[AI assistant] -->|MCP over stdio| B[chrome_control_mcp]
    B -->|Windows named pipe<br/>Linux/macOS Unix socket| C[Native-host relay]
    C -->|Chrome native messaging| D[Unpacked MV3 extension]
    D -->|Chrome DevTools Protocol| E[Active Chrome tab]

1つの実行可能ファイルがMCPサーバーとネイティブホストリレーの両方の役割を提供します。ブラウザ制御は、呼び出し可能なツール、画像結果、強化されたIPC、永続的なセッション状態が必要なため、MCPに属します。スキルはワークフローを追加できますが、サーバーを置き換えることはありません。

セキュリティモデル

完全な制御は強力です。Chrome Control MCPは拡張機能のオリジンを固定し、IPCを制限・検証し、同じユーザー/同じ実行可能ファイルのリレーを認証し、古い要素参照とスクリーンショット座標を拒否し、主要なペイロードを制限し、厳密なスキーマを公開します。

Windowsは現在のユーザーのACLで保護された名前付きパイプを使用します。LinuxとmacOSは、プライベートランタイムディレクトリ内のモード0600のUnixソケットと、オペレーティングシステムのピア資格情報を使用します。

検査専用の使用の場合:

CHROME_CONTROL_MCP_SECURITY_PROFILE=read_only
CHROME_CONTROL_MCP_REDACT_SENSITIVE_OUTPUT=true

読み取り専用プロファイルは10個のツールを公開し、隠れた変更呼び出しを独立して拒否します。

検証

ローカルのWindowsおよびLinuxゲートは現在以下をカバーしています:

• MSVC、GCC、Clangによる9/9のネイティブおよび拡張スイート

• 警告をエラーとして扱うことに加え、clang-tidyと網羅的なcppcheck

• 個別のASan+UBSanおよびTSan実行

• 全履歴のGitleaksスキャンとnpm依存関係監査

• 実際のChromeを通したWindows上の43/43のライブMCPツール

• 公開UI Playgroundのナビゲーション、スナップショット、タイピング、クリック、PNGキャプチャ

• 元に戻せるネイティブホストのインストール/ステータス/アンインストールライフサイクル

GitHub Actionsは、直接プッシュのたびにWindows、Linux、macOSでビルドとテストを実行します。

npm run smoke
npm run smoke:read-only
node tests/e2e/full_browser_e2e.mjs

PowerShellのライブ公開サイトチェック:

./scripts/live_browser_verify.ps1 -Site http://uitestingplayground.com/

正確な証拠と主張の境界を参照。

プロジェクトID

現在のユーザーのネイティブホストをnpm run extension -- uninstallで登録解除し、廃止するときにchrome://extensionsからパッケージ化されていない拡張機能を手動で削除します。

ライセンス

MIT Licenseでリリースされています。Copyright © 2026 Randy Northrup.