Mcp

Browser MCP

Browser MCP を使うと、AI アプリ（Claude Code、Cursor、VS Code、Codex、Claude Desktop など）から、ご自身の Chrome を利用できます。サインイン済みのサイトやプロフィールを、AI アプリ専用のタブで操作できます。すべてお使いのコンピューター上で実行されます。

• ウェブサイトとドキュメント：browsermcp.io、ドキュメント
• 拡張機能：Chrome ウェブストア、または自分でビルド
• MCP サーバー：npm の @browsermcp/mcp

仕組み

各 AI アプリは MCP サーバー（npx @browsermcp/mcp@latest）を実行します。これは、ユーザーごとに 1 つのデーモンを起動する小さなプロセスで、アプリからの browser ツール呼び出しをデーモンに転送します。デーモンは拡張機能を介して Playwright でブラウザーのタブを操作します。拡張機能は薄い chrome.debugger リレーで、127.0.0.1 上のデーモンとのみ通信します。また、ポップアップで Allow をクリックする前に、AI アプリに表示された 6 桁のコードと一致することを確認する必要があります。この操作はコンピューターごとに一度だけです。拡張機能は、デーモンからの要求にかかわらず、シークレットモード、ブラウザーや拡張機能のページ、および Stop を押した後のすべての操作を禁止します。

フォルダー	パッケージ
packages/mcp	@browsermcp/mcp	MCP サーバーとデーモン（README）
packages/protocol	@browsermcp/protocol	拡張機能とデーモン間のプロトコル。ペアリングも含みます
packages/extension-core	@browsermcp/extension-core	拡張機能のブラウザー制御機能。接続、ペアリング、デバッガーリレー、タブ、タブグループ、バッジに関するルール
apps/extension	@browsermcp/extension	このリポジトリからビルドされる拡張機能。ブラウザー制御とポップアップを備えています

自分でビルド

Node.js 24 以降、pnpm（corepack enable）、Chrome またはその他の Chromium ブラウザー（Edge、Brave、Arc など）が必要です。Firefox には debugger API がないため、Browser MCP は Firefox では動作しません。

1. 拡張機能とサーバーをビルドします。

   git clone https://github.com/BrowserMCP/mcp.git browsermcp
   cd browsermcp
   pnpm install
   pnpm build
   

2. chrome://extensions を開き、Developer mode をオンにして、Load unpacked をクリックし、apps/extension/.output/chrome-mv3 を選択します。拡張機能の名前は「Browser MCP (self-built)」です。同じプロフィールに Chrome ウェブストア版の Browser MCP がインストールされている場合は、同時にサーバーを使用できるのはどちらか一方だけなので、オフにしてください。

3. AI アプリの MCP 設定で、npm 版ではなくビルドしたサーバーを実行します。

   {
     "mcpServers": {
       "browsermcp": {
         "command": "node",
         "args": ["/path/to/browsermcp/packages/mcp/dist/index.js"]
       }
     }
   }
   

   npx @browsermcp/mcp@latest（ドキュメントに記載されたセットアップ方法）もこの拡張機能で使えます。同じサーバーをこのリポジトリから公開しているためです。

4. AI アプリを再起動し、ブラウザーで何か操作するように依頼します。初回は拡張機能のポップアップで、このコンピューター上のサーバーを Allow するよう求められます。コードが AI アプリに表示されたコードと一致することを確認してください。

この拡張機能をビルドすると、すべて同じ ID（apps/extension/extension-key.ts の key による imlplcjlhgpajopdbpbngiadkcmdbgob）になります。この ID は Chrome ウェブストア版の ID と同様に、サーバーで受け入れられます。別のキーを使用してビルドした場合は、サーバーの環境変数 BROWSER_MCP_EXTENSION_IDS（カンマ区切り）にその ID を設定するか、~/.browsermcp/dev-extension-ids に 1 行で記載する必要があります。

更新

git pull
pnpm install
pnpm build

その後、chrome://extensions で「Browser MCP (self-built)」の再読み込みボタンをクリックします。このフォルダーからサーバーを実行している場合は、AI アプリも再起動してください。拡張機能とサーバーは、相手側のバージョンが古くて動作できない場合に通知します。

開発

• pnpm lint、pnpm format（修正するには pnpm format:fix）：Oxlint と Oxfmt。
• pnpm typecheck、pnpm test：すべてのパッケージの TypeScript と単体テスト（Vitest）。サーバーのテストでは Playwright の Chromium を実行します。pnpm --filter @browsermcp/mcp exec playwright-core install chromium を一度実行してインストールしてください。
• pnpm smoke：開発モードで拡張機能とサーバーをビルドし、ヘッドレス Chromium に拡張機能を読み込んで、AI アプリと同様にサーバー経由で操作します。ランダムなポートと一時的な BROWSER_MCP_HOME を使用するため、使用中の Browser MCP には一切触れません。スクリーンショットは apps/extension/.output/smoke/ に保存されます。
• pnpm --filter @browsermcp/extension build:dev：開発ビルド（apps/extension/.output/chrome-mv3-dev）。

コントリビューションとセキュリティ

バグの報告や変更の送信方法については CONTRIBUTING.md を、脆弱性を非公開で報告する方法については SECURITY.md をご覧ください。

ライセンス

Apache-2.0。「Browser MCP」とそのロゴは本プロジェクトの商標です。拡張機能またはサーバーを改変して公開する場合は、別の名前とアイコンを使用してください（TRADEMARKS.md）。