Browse Together MCP

🚀 ブラウザープロキシサービスとMCPサーバー（Playwright Browser Proxy with MCP Server）

このプロジェクトは、PlaywrightブラウザーとMCPサーバーをデスクトップ上で実行することができます。人間が操作するための有頭ブラウザーと、HTTP APIまたはMCPサーバーを通じてブラウザーを制御できるMCPサーバーを起動することができます。

このプロジェクトは、ブラウザー自動化と共同閲覧のための2つの相補的なサービスを提供します：

• ブラウザープロキシサービス：HTTPを通じて永続的なPlaywrightブラウザーインスタンスを制御します。通常通りに使用するサービスにログインすることができます。
• MCPサーバー：FastMCPフレームワークを通じて、ブラウザー機能をMCPクライアント（Claude Desktopなど）に公開します。提供された認証セッションで実行できるため、MCPコマンドにより多くの権限と用途を持たせることができます。

両方のサービスはDenoとTypeScriptで構築されており、シームレスに連携します。

✨ 主な機能

• 多ブラウザー対応：Chromium（デフォルト）またはFirefoxをサポートします。
• 永続的なブラウザーセッション：ブラウザーインスタンスはサービスのライフサイクル中ずっと実行されます。
• ページ管理：アクティブなすべてのブラウザーページを一覧表示し、特定のページを閉じることができます。
• コンテンツ操作：フォームフィールドに入力、要素をクリック、ページのHTMLコンテンツを取得、ブラウザーコンテキスト内でfetchリクエストを実行することができます。

📚 ドキュメント

このプロジェクトは、一連のドキュメントで段階的な計画手順を説明しています：

• 初期設計決定（注意：プロジェクト構造の説明は古くなっている可能性があります）
• ブラウザープロキシサービスの概要（マルチセッション - 履歴）
• 単一セッションアーキテクチャの再構築
• 型安全計画（Zod）
• ページの回復力計画
• 使用するライブラリ
• テスト戦略
• 設定
• セキュリティ上の考慮事項
• Denoのベストプラクティス
• MCPサーバーの実装計画
• FastMCPの再構築

これらの手順の一部は古くなっているか、関連性がなくなっている可能性がありますが、プロジェクトの構築方法を理解するための参考として含まれています。

私たちのローカルなサンディ（Sandy）ユタ州のバイブコーダーズグループについての詳細は、vibe-coders.orgをご覧ください。

🚀 クイックスタート

開発

• ブラウザープロキシを実行：deno task browser
• MCPサーバーを実行：deno task mcp
• コードをフォーマット：deno fmt
• 依存関係をチェック：deno check --all browser.ts mcp.ts types.ts

🔧 技術詳細

アーキテクチャ

+----------------+      +--------------+      +------------------+
|                |      |              |      |                  |
| Cline/LLM      | ---- | MCP Server   | ---- | Browser Service  |
| (MCP クライアント)   |      | (mcp.ts)     | HTTP | (browser.ts)     |
|                |      |              |      |                  |
+----------------+      +--------------+      +------------------+
                               |                       |
                          FastMCP API            Playwright API
                               |                       |
                           標準入力/出力ストリーム       Chromium ブラウザー

システムの動作原理は以下の通りです：

1. ブラウザーサービス（browser.ts）はPlaywrightを使用して、永続的なChromiumブラウザーインスタンスを管理します。
2. MCPサーバー（mcp.ts）はFastMCPを使用して、標準的なMCPインターフェースを提供します。
3. MCPサーバーはHTTPを通じてブラウザーサービスにコマンドを転送します。
4. MCPクライアント（Claude Desktopなど）は、簡単なツール呼び出しですべてのブラウザー機能を使用することができます。