Browser Ctl

🚀 ブラウザ CTL MCP サーバー

SSE と Anthropic をベースにしたブラウザ制御 MCP サーバーです。Python Playwright を使用して構築され、AI エージェントがウェブブラウザを制御して相互作用するための一連のツールを提供します。この簡易版では Chrome ブラウザを使用しています。

✨ 主な機能

1. JavaScript の実行

Playwright の評価メソッドを利用して、リアルタイムのブラウザで JavaScript コードを実行し、スクリプトの結果を返します。

2. URL のアクセス

ターゲットのウェブサイトにアクセスし、リアルタイムのブラウザで開きます。

3. 待機遅延

ブラウザが指定された時間（開始時間と終了時間の間）ランダムに待機します。

4. ブラウザの閉じる

開いているブラウザウィンドウを閉じます。

5. ブラウザの開く

リアルタイム環境でブラウザを起動します。

6. ブラウザのスクリーンショットの取得

現在のブラウザページのスクリーンショットを取得し、Base64 形式で画像データを返します。

📚 ドキュメント

デフォルトのログ

この MCP サーバーはデフォルトで情報ログレベルで起動します。

# 配置日志记录
logging.basicConfig(
    level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s"
)

デフォルトのエンドポイント

http://127.0.0.1:8001/sse

📦 インストール

まず、uv をインストールし、Python プロジェクトと環境を設定します。

Linux システム

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows システム

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

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

git clone https://github.com/biteval/browser_ctl.git

プロジェクトディレクトリに移動します。

cd browser_ctl

仮想環境の作成とアクティブ化

uv init

uv venv

Linux システム

source .venv/bin/activate

Windows システム

.venv\Scripts\activate

依存関係のインストール

Linux システム

uv add "mcp[cli]" httpx playwright

Windows システム

uv add mcp[cli] httpx playwright

Playwright ブラウザのバイナリファイルのダウンロード

python -m playwright install

ブラウザ CTL MCP サーバーの起動

python browser_ctl.py

🤝 コントリビューションを歓迎します！

あなたの専門知識とアイデアはこのプロジェクトに大きな影響を与えます。ご参加いただき、ありがとうございます！

📺 詳細情報

AI エージェントの作成方法を知るには、私たちの YouTube チャンネルをご覧ください。