brawsr

brawsr MCP サーバー

brawsr ブラウザーセッション、チェックポイント、巻き戻し、フォークに対応する、認証済みのローカル MCP ブリッジです。公式パッケージの @brawsr/sdk を使用しており、API モデル、オーケストレーションのポーリング、ブラウザー／CDP の動作を複製しません。

v0.2 のトランスポートはローカル stdio で、Node.js 22 以降が必要です。

インストールと設定

MCP クライアントはサーバーをローカルで起動します。MCP クライアントの再起動時に新しいリリースが予期せず選択されないよう、クライアント設定でパッケージのバージョンを固定してください。

{
  "mcpServers": {
    "brawsr": {
      "command": "npx",
      "args": ["-y", "@brawsr/[email protected]"],
      "env": {
        "BRAWSR_API_KEY": "your-brawsr-api-key"
      }
    }
  }
}

npm パッケージには公式の @brawsr/sdk が含まれているため、別途パッケージをインストールする必要はありません。必須の環境変数は BRAWSR_API_KEY のみです。本番エンドポイント https://api.brawsr.io は組み込みです。

ローカル開発または別のデプロイ環境では、BRAWSR_BASE_URL を明示的に指定してこのエンドポイントを上書きできます。BRAWSR_MCP_TIMEOUT_MS を指定すると、デフォルトの最大待機時間 30 秒を変更できます。値には 1 から 300000 までの整数を指定します。

API キーがツールの引数や結果に含まれることはありません。標準出力は MCP プロトコルメッセージ専用です。秘匿情報をマスキングしたライフサイクル診断情報は標準エラーに出力されます。シェルから直接起動する場合も、同じ実行ファイルを使用します。

BRAWSR_API_KEY=... npx -y @brawsr/[email protected]

ツール

• brawsr_create_session、brawsr_list_sessions、brawsr_get_session、 brawsr_update_session_label、brawsr_close_session
• brawsr_close_sessions
• brawsr_create_checkpoint、brawsr_get_checkpoint、 brawsr_list_checkpoints、brawsr_delete_checkpoint
• brawsr_list_rewindable_checkpoints、brawsr_list_session_activity、 brawsr_get_session_lineage
• brawsr_rewind、brawsr_fork
• brawsr_get_operation、brawsr_wait_operation

セッションの作成時には、任意で display_label を指定できます。同じラベルは、brawsr_update_session_label を 1 回呼び出すことで変更またはクリアできます。セッション一覧は新しい順で、件数に上限があり、保持されているクローズ済みまたは期限切れのセッションが含まれる場合があります。brawsr_get_session は、セッションに接続可能な場合にのみ CDP URL を含みます。

brawsr_list_checkpoints はキャプチャ履歴を返します。監査やダッシュボード表示のために、削除済みのキャプチャが含まれる場合があります。有効な巻き戻し先またはフォーク先を選ぶ際は、brawsr_list_rewindable_checkpoints を使用してください。系譜情報は、1 つのセッション、その任意の親フォークエッジ、および直接の子の上限付きページを返します。呼び出し元は子セッション ID をたどって、ネストされたフォークツリーを閲覧できます。ページネーションカーソルは不透明で、変更せずにそのまま渡せます。

チェックポイント、巻き戻し、フォークは、1 回の高レベルツール呼び出しで実行できます。パッケージに含まれる SDK が、通常の 202 ポーリングを処理します。巻き戻しは、結果が CDP で使用可能になった時点で返されます。復元後の処理は、その後も上限付きでバックグラウンド実行される場合があります。タイムアウトによって停止するのはローカルでの待機のみです。操作／冪等性に関する復旧フィールドが返され、サーバー側の処理は継続します。

フォークされた子セッションは独立した同列のセッションであり、暗黙に勝者や敗者となるものではありません。ブラウザー状態のマージや、兄弟セッションの自動クリーンアップはありません。巻き戻しで復元されるのはブラウザー／クライアントの状態であり、リモート Web サイトへの副作用は復元されません。また、古い CDP／ブラウザーハンドルは無効になります。長時間維持される WSS／SSE／WebRTC ストリームは、アプリケーション側で再接続が必要になる場合があります。

CDP URL は機密性の高い構造化出力です。MCP サーバーが Authorization ヘッダーを返すことはありません。接続には通常の SDK またはサポート対象のフレームワークを使用してください。MCP サーバーは CDP をプロキシしません。

リモート Streamable HTTP、OAuth、ホスト型のマルチテナント、レガシー HTTP+SSE、および再開可能な MCP セッションは、ローカル v0.2 stdio の範囲外として、今後の対応に延期されています。

開発

npm ci
npm run verify

リリースアーカイブは、固定された Node 24 および npm 11.5.1 のツールチェーンを使って再現可能な方法でビルドされます。CI では、Node 22 と Node 24 の両方でサーバーと実際の MCP クライアント境界もテストします。実行可能パッケージは npm で公開され、io.github.brawsr/brawsr の検出用メタデータは公式 MCP Registry で公開されます。