Browser Automation

🚀 MCP ブラウザープロキシ

AGI House MCP ハッカソンイベントで構築されました。

このプロジェクトは、Model Context Protocol（MCP）を通じてブラウザーとのインタラクションを実現するブラウザー自動化プロキシです。MCP サーバーを介して、Claude にブラウザー操作機能をシームレスに統合します。

Browser-Use がブラウザープロキシ機能を提供し、私たちの MCP サーバーをサポートしてくれたことに感謝します！

🚀 クイックスタート

システム要件

• macOS（darwin 24.2.0）
• Python 3.12 以上
• uv パッケージマネージャー
• Google Chrome ブラウザー（タスク実行時はブラウザーが閉じていることを確認）

インストール方法

Smithery を使用した自動インストール

Smithery を通じて、Claude Desktop のブラウザー自動化プロキシを自動インストールします。

npx -y @smithery/cli install @ashley-ha/mcp-manus --client claude

手動インストール

1. リポジトリをクローンします。

git clone <repository-url>
cd mcp

2. uv を使用して Python 環境を設定します。

uv venv
source .venv/bin/activate
uv sync

設定方法

Claude Desktop の設定

Claude Desktop の設定ファイルを作成または編集します。

{
  "mcpServers": {
    "browser-use": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/mcp",
        "run",
        "browser-use.py"
      ]
    }
  }
}

/ABSOLUTE/PATH/TO/browser-use をプロジェクトディレクトリの絶対パスに置き換えてください。

ブラウザーの設定

プロキシはデフォルトで Google Chrome を使用し、以下の設定が適用されます。

• 非ヘッドレスモード（開発用）
• ウィンドウサイズ：1280x1100
• セキュリティ機能の無効化（テスト用）
• 録画パス：./tmp/recordings

✨ 主な機能

• MCP ツール操作をサポートするブラウザー自動化
• 状態管理と計画機能
• インタラクティブ要素の検出と操作
• ブラウザーコンテキストの設定可能
• 記録とデバッグサポート

💻 使用例

基本的な使用法

プロキシは以下の 2 つの主要なツールを提供します。

1. get_planner_state：現在のブラウザー状態と計画コンテキストを取得します。
2. execute_actions：ブラウザーで計画された操作を実行します。

🔧 技術詳細

ログ記録

プロジェクトは Python の組み込み logging モジュールを使用し、以下のように構成されています。

• すべてのログは標準エラー出力に出力されます。
• カスタムフォーマット：%(levelname)-8s [%(name)s] %(message)s
• ルートロガーのレベル：INFO
• サードパーティロガーのレベル：WARNING

プロジェクト構造

• browser-use.py：メインエントリーポイントとサーバーの実装
• tmp/recordings：ブラウザーセッションの録画フォルダ
• 依存関係の管理は uv を通じて行われます。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については LICENSE ファイルを参照してください。

著作権 © 2025 Jaeyun Ha, Ashley Ha

以下の条件の下で、誰でも無料でこのソフトウェアおよび関連するドキュメントファイル（「ソフトウェア」）を取得、複製、使用、変更、統合、公開、配布、再ライセンスおよび/または販売することができます。

1. すべてのコピーまたは一部のコピーにこの著作権表示を含めること。
2. 上記の声明を変更しないこと。

ソフトウェアに関するいかなる請求、損害またはその他の責任について、その原因が何であれ、法的に許される最大限の範囲で、作者または著作権所有者は一切の責任を負いません。