Browser Use MCP Server

🚀 環境変数設定

MCP_USE_OWN_BROWSER

true に設定すると、サーバーが既存のブラウザーインスタンスに接続するように指示します。

CHROME_CDP

Chrome ブラウザーの開発者ツールプロトコル（DevTools Protocol）の URL アドレスを指定します。形式は以下の通りです。

http://host:port

設定例

.env ファイルまたはシステム環境変数に以下の内容を設定します。

MCP_USE_OWN_BROWSER=true
CHROME_CDP=http://localhost:9222 # Chrome を起動するのと同じポートを使用

🚀 クイックスタート

ステップ 1：Chrome ブラウザーを起動する

--remote-debugging-port フラグを使用して Chrome を起動します。

google-chrome --remote-debugging-port=9222

ポート 9222 が既に使用されている場合は、他のポート（例：9223）を選択し、CHROME_CDP 環境変数を適宜更新してください。

ステップ 2：環境変数を設定する

MCP サーバーを起動する前に、以下の環境変数を設定します。

MCP_USE_OWN_BROWSER=true
CHROME_CDP=http://localhost:9222 # Chrome を起動するのと同じポートを使用

ステップ 3：MCP サーバーを実行する

通常の手順で MCP サーバーを起動します。

uv run mcp-server-browser-use

⚠️ 注意事項

• ブラウザーの状態：MCP_USE_OWN_BROWSER=true を使用する場合は、Chrome ブラウザーが開いていることを確認してください。
• ポートのアクセス：CHROME_CDP URL が MCP サーバーからアクセス可能であることを確認してください（通常は同じマシン上の http://localhost:PORT）。
• ブラウザーウィンドウのサイズ：MCP サーバーは、現在の Chrome ウィンドウの実際のサイズを使用し、環境変数の設定ではなくなります。

🔧 開発ガイド

# 開発依存関係をインストールし、プロジェクトの依存関係を同期する
uv sync --dev

# Playwright ブラウザーをインストールする
uv run playwright install

# デバッグツールを使用する（例：ローカルの Chrome に接続する）
# 1. Chrome を起動する：google-chrome --remote-debugging-port=9222
# 2. デバッグコマンドを実行する：
npx @modelcontextprotocol/inspector@latest \
  -e OPENROUTER_API_KEY=$OPENROUTER_API_KEY \
  -e MCP_MODEL_PROVIDER=openrouter \
  -e MCP_MODEL_NAME=anthropic/claude-3.7-sonnet \
  -e MCP_USE_OWN_BROWSER=true \
  -e CHROME_CDP=http://localhost:9222 \
  uv --directory . run mcp run src/mcp_server_browser_use/server.py
# 注意：必要に応じてタイムアウト時間を調整してください（デフォルトは 10 秒）

🛠️ トラブルシューティング

• ブラウザーの競合：MCP_USE_OWN_BROWSER=false の場合、他の Chrome インスタンスが同じユーザーデータディレクトリを使用していないことを確認してください。
• CDP 接続の問題：
  • Chrome が --remote-debugging-port フラグを使用して起動されていることを確認してください。
  • CHROME_CDP ポートが正しいことを確認し、ファイアウォールがそのポートへのアクセスをブロックしていないことを確認してください。
  • ブラウザーインスタンスがまだ実行中であることを確認してください。
• API エラー：関連する API キーと設定が正しいことを確認してください。
• 開発者ツールプロトコルの問題：Chrome ブラウザーのバージョンが必要な DevTools 機能をサポートしていることを確認してください。

🖼️ 画像説明

この画像は、MCP サーバーでカスタムブラウザーインスタンスを統合して使用する方法を示しています。