Auto Browser

AIエージェントに、人間が介在可能な本物のブラウザを与えましょう。

Auto Browserは、承認されたワークフローのためのMCPネイティブなブラウザ制御プレーンです。MCPクライアント、LLMエージェント、およびオペレーターに対して、人間によるテイクオーバー（介入）、再利用可能な認証プロファイル、承認機能、監査証跡、ローカルファーストなデプロイメントを備えた共有Playwrightブラウザを提供します。

対応環境:

• Claude Desktop

• Cursor

• HTTPまたはstdioで通信可能なあらゆるMCPクライアント

• curlベースの制御を好む場合の直接REST呼び出し

Auto Browserを選ぶ理由

• 最初からMCPネイティブ。 ブラウザのインターフェースは、後付けではなく、MCPサーバーとしてパッケージ化されています。

• Webが不安定な時の人間によるテイクオーバー。 noVNCにより、人が介入する必要がある際に、同じライブセッションをそのまま利用できます。

• 一度ログインすれば、再利用可能。 名前付き認証プロファイルを保存し、ログイン済みの状態で新しいセッションを再開できます。

• デフォルトでローカルファースト。 Docker Composeを使用して自分のマシンでフルスタックを実行するか、Codespacesを使用して素早くホスト型デモを試すことができます。

• 安全レールを内蔵。 承認機能、オペレーターID、PII（個人識別情報）のスクラブ、Witnessレシート、コンプライアンス・テンプレートが製品のインターフェースの一部として組み込まれています。

Related MCP server: Browser-Use MCP Server

リリースハイライト (v1.0.2)

• フレームワークのセキュリティ更新（FastAPIとStarletteを現在のパッチ適用済みラインに固定）

• より安全なエラー境界（ブラウザアクション、CDP、OCR、メッシュ、ワークフロー、トンネル、ソーシャル、共有トークンの各インターフェース全体）

• レート制限の強化（バケット制限とハッシュ化されたオペレーター識別子による）

• ホストおよびパスポリシーの厳格化（本番環境の ALLOWED_HOSTS、認証プロファイルのパス、アップロードルートに対して）

• 1.0プラットフォームインターフェース（署名付きメッシュ委任、ワークフロールート、/dashboard、noVNCテイクオーバー、MCPトランスポート、監査証跡、レディネスチェックを含む）

リリース履歴の詳細は CHANGELOG.md を参照してください。

適した用途

• 社内ダッシュボードおよび管理ツール

• オペレーター支援によるQAおよびブラウザデバッグ

• 一度ログインして後で再利用するアカウントワークフロー

• 人間がフローを復旧させる必要があるような不安定なサイト

• HTML取得だけでなく、本物のブラウザを必要とするMCP駆動のエージェントワークフロー

対象外の用途

• ステルスやアンチボット対策

• CAPTCHAの解決

• 不正なスクレイピングやアカウント自動化

• 欺瞞的なID生成やバイパスツール

提供機能

クイックスタート

git clone https://github.com/LvcidPsyche/auto-browser.git
cd auto-browser
docker compose up --build

デフォルト設定でのローカル開発にはこれで十分です。

オプション:

cp .env.example .env
make doctor

通常のターミナルから、ローカルのDockerアクセス権限とlocalhostソケットを開く権限がある状態で make doctor を実行してください。

アクセス先:

• APIドキュメント: http://127.0.0.1:8000/docs

• オペレーターダッシュボード: http://127.0.0.1:8000/dashboard

• ビジュアルテイクオーバー: http://127.0.0.1:6080/vnc.html?autoconnect=true&resize=scale

公開ポートはすべてデフォルトで 127.0.0.1 にバインドされます。

Codespacesで試す

Codespacesはスタックを自動的にプロビジョニングします。ダッシュボードとnoVNCタブは通常90秒以内に準備が整います。

最初の便利なデモ

このリポジトリで最も重要なフローは以下の通りです:

1. セッションを作成する

2. サイトが人間を必要とする場合は手動でログインする

3. セッションを名前付き認証プロファイルとして保存する

4. その認証プロファイルから新しいセッションを開く

5. 再認証なしで作業を継続する

ここから始めてください:

• examples/login-and-save-profile.md

• examples/README.md

最小限のセッション作成:

curl -s http://127.0.0.1:8000/sessions \
  -X POST \
  -H 'content-type: application/json' \
  -d '{"name":"demo","start_url":"https://example.com"}' | jq

最小限の観測:

curl -s http://127.0.0.1:8000/sessions/<session-id>/observe | jq

MCPクライアント

Auto Browserは以下を公開しています:

• http://127.0.0.1:8000/mcp にあるHTTP MCPエンドポイント

• http://127.0.0.1:8000/mcp/tools および http://127.0.0.1:8000/mcp/tools/call にある便利なエンドポイント

• scripts/mcp_stdio_bridge.py にあるバンドルされたstdioブリッジ

デフォルトのMCPツールプロファイルは curated であり、ブラウザのインターフェースをコンパクトに保つことでツール選択を最適化しています。内部ツールをすべて使用したい場合は、以下を設定してください:

MCP_TOOL_PROFILE=full

生のツール呼び出しの例:

curl -s http://127.0.0.1:8000/mcp/tools/call \
  -X POST \
  -H 'content-type: application/json' \
  -d '{
    "name":"browser.create_session",
    "arguments":{
      "name":"demo",
      "start_url":"https://example.com"
    }
  }' | jq

クライアント設定ガイド:

• docs/mcp-clients.md

• examples/claude-desktop-setup.md

• examples/cursor-mcp-setup.md

• examples/claude_desktop_config.json

セキュリティとコンプライアンス

実際のプライベートデプロイメントでは、少なくとも以下を設定してください:

APP_ENV=production
API_BEARER_TOKEN=<strong-random-secret>
REQUIRE_OPERATOR_ID=true
AUTH_STATE_ENCRYPTION_KEY=<44-char-fernet-key>
REQUIRE_AUTH_STATE_ENCRYPTION=true
REQUEST_RATE_LIMIT_ENABLED=true
METRICS_ENABLED=true

COMPLIANCE_TEMPLATE は起動時に事前設定された姿勢を適用できます:

すべてのテンプレートでアップロードの承認が必要です。HIPAA、SOC2、PCI-DSS はWitnessレシートも有効にします。起動時に適用されたポリシーが /data/compliance-manifest.json に書き込まれます。

例:

COMPLIANCE_TEMPLATE=HIPAA docker compose up

デプロイメントの詳細、ホストされたWitnessノート、CLI認証モード、リバースSSHガイダンスについては、以下を参照してください:

• docs/deployment.md

• docs/production-hardening.md

アーキテクチャの概要

flowchart LR
    User[Human operator] -->|watch / takeover| noVNC[noVNC]
    LLM[OpenAI / Claude / Gemini] -->|shared tools| Controller[Controller API]
    Controller -->|Playwright protocol| Browser[Browser node]
    noVNC --> Browser
    Browser --> Artifacts[(screenshots / traces / auth state)]
    Controller --> Artifacts
    Controller --> Policy[Allowlist + approval gates]

主要コンポーネント:

• browser-node/: Chromium、Xvfb、x11vnc、noVNCを実行

• controller/: FastAPIコントローラー、MCPトランスポート、ポリシーレール、オーケストレーションエンドポイントを公開

• data/: ランタイムアーティファクト、認証状態、承認、監査ログ、オプションのCLIキャッシュを保持

• scripts/: doctor、スモークテスト、ブリッジ、リリースチェック用のローカルヘルパーを格納

リポジトリガイド

一般的なコマンド

ドキュメントマップ

貢献

協力していただける場合は、以下から始めてください:

• CONTRIBUTING.md

• docs/good-first-issues.md

• CODE_OF_CONDUCT.md

Auto Browserが役に立った場合は、スターを付けていただけると他の人が見つけやすくなります。