Browser Navigator MCP

AIアシスタントにBraveブラウザの完全な制御をCDP（Chrome DevTools Protocol）経由で提供するModel Context Protocol（MCP）サーバー。OSINT調査、ソーシャルメディアクローリング、一般的なWeb自動化のために構築されました。

既存のBraveインスタンスに接続し（または新しいものを起動し）、タブには触れません。ブラウザに接続するのであって、クローンコピーではありません。

機能

• 🧭 完全なブラウザ制御 — ナビゲート、クリック、タイピング、スクロール、ホバー、スクリーンショット、PDFエクスポート

• 🪟 ウィンドウとタブの管理 — ウィンドウ/タブの一覧表示、開く、切り替え、閉じる

• 🔐 CAPTCHA検出 — reCAPTCHA、hCaptcha、Cloudflare Turnstile、チャレンジを自動検出し、人間が解決するのを待ちます

• 🍪 セッション永続化 — クッキーを保存/読み込みして、実行間でログイン状態を維持

• 🎥 ビデオ制御 — 任意のHTML5プレーヤー（YouTubeなど）で再生/一時停止/シーク/音量

• 🔍 ソーシャル検索 — Google、X/Twitter、Instagram、Facebook、LinkedIn、TikTok、YouTubeを横断するワンツール検索

• 🔧 任意のJS — その他の操作はexecute_js（明示的な確認フラグ付き）

• 🏥 ヘルスチェック — サーバーとブラウザの接続状態を確認

要件

• Node.js 20以上

• Braveブラウザ（標準パスにインストールされているか、BRAVE_PATHで指定）

• Playwrightブラウザのダウンロードは不要 — サーバーはCDP経由でBraveを直接操作します

インストール

git clone <your-repo-url>
cd brave-browser-mcp
npm install

クイックスタート

1. デバッグポート付きでBraveを起動

./launch-brave.sh

これにより、--remote-debugging-port=9222でBraveが起動します。既存のBraveインスタンスを強制終了することはありません — ポート9222がすでに使用中の場合はそのままにします。

または、brave --remote-debugging-port=9222で手動でBraveを起動します。 Braveがデバッグポートなしで既に実行されている場合、MCPは閉じて再試行するよう求めます — 実行中のブラウザを自動的に強制終了することはありません。

2. サーバーを実行

node index.js

サーバーはstdio経由でMCPを話します。connect_braveは実行中のBraveインスタンスに自動的に接続します。

3. MCPサーバーとして登録

opencodeの場合は、opencode.jsonに追加します：

{
  "mcp": {
    "browser-navigator": {
      "type": "local",
      "command": ["node", "index.js"],
      "cwd": "/absolute/path/to/brave-browser-mcp",
      "enabled": true
    }
  }
}

Claude Desktopの場合は、claude_desktop_config.jsonに追加します：

{
  "mcpServers": {
    "browser-navigator": {
      "command": "node",
      "args": ["/absolute/path/to/brave-browser-mcp/index.js"]
    }
  }
}

ツール

CAPTCHA処理

CAPTCHAはnavigate / navigate_historyの後に自動的に検出され、get_page_infoで報告されます。未解決のCAPTCHAが見つかると、自動化は一時停止してユーザーにブラウザでの解決を求めます — このツールはCAPTCHAを回避できません（また回避しません）。

検出されるタイプ: reCAPTCHA、hCaptcha、Cloudflare Turnstile、Cloudflare Challenge。

セキュリティに関する注意

• execute_jsはconfirm=trueが必要で、5000文字/50KBの出力に制限されています。

• スクリーンショットとクッキーのパスは、パストラバーサルに対してサニタイズされています。

• クッキーは0o600のパーミッションで保存され、ディレクトリは0o700です。

• サーバーは自分が起動していないブラウザを強制終了することはありません。

• 完全なセキュリティとコード品質の監査については、AUDIT.mdを参照してください。

テスト

このスイートは、実際のMCP stdioプロトコルを介してサーバーを駆動します（ポート9222でBraveが実行されている必要があります）：

node test.cjs

ナビゲーション、CAPTCHA、タブ、ウィンドウ、スクリーンショット、クッキー、ビデオ、セキュリティ強化をカバーする53のアサーション。

ライセンス

PolyForm Noncommercial 1.0.0 — LICENSEを参照してください。

非商用目的（個人、研究、教育、趣味、慈善団体、政府）であれば自由に使用できます。商用利用の場合は、最初に作者に連絡してください — このプロジェクトを商用で使用する前にご連絡ください。