Multilogin Browser MCP

Multilogin X アンチ検出ブラウザプロファイルを CDP 経由で操作し、ストリーミング可能な HTTP MCP サーバーを通じて AI エージェントに公開する FastAPI サービスです。

特徴

• プロファイル管理 — Multilogin プロファイルの一覧表示、検索、作成、削除（バッチ作成は人為的な上限なしでサポート）。

• ブラウザセッション — プロファイルの起動、CDP 経由での Playwright 接続、セッションライフサイクルの管理。

• ブラウザアクションカタログ — ナビゲーション、クリック、タイピング、JS 評価、スクリーンショット、タブ、クッキー、スクロール、ホバーなど。

• デュアルインターフェース — 統合用の REST API とエージェントフレームワーク用の MCP。

• セッションウォッチドッグ — 最大 TTL 15 分とアイドルタイムアウトによるクリーンアップ。

• Railway 対応 — PORT と .env で駆動。

Related MCP server: BrowserPilot

要件

• Python 3.12+

• ローカルで実行中の Multilogin デスクトップアプリ / エージェント（ランチャーを https://launcher.mlx.yt:45001 で公開し、127.0.0.1 に解決）

• Multilogin オートメーショントークン、またはユーザー名 + パスワード

インストール

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

playwright install は不要です — Multilogin が起動するブラウザに CDP 経由で接続します。

設定

サンプルをコピーして値を入力してください:

cp .env.example .env

# Option A: automation token (recommended for servers)
MULTILOGIN_AUTOMATION_TOKEN=your_token

# Option B: username + password
# MULTILOGIN_USERNAME=you@example.com
# MULTILOGIN_PASSWORD=your_password

# Optional overrides
# MULTILOGIN_API_URL=https://api.multilogin.com
# MULTILOGIN_LAUNCHER_URL=https://launcher.mlx.yt:45001
# PORT=8000
# SESSION_MAX_TTL_SECONDS=900
# SESSION_IDLE_TIMEOUT_SECONDS=300

実行

python main.py
# or
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

• REST ドキュメント: http://localhost:8000/docs

• MCP エンドポイント: http://localhost:8000/mcp/（POST; GET /mcp はここにリダイレクト）

REST API

フロー例

# 1. list profiles
curl http://localhost:8000/api/v1/profiles/

# 2. launch a session
curl -X POST http://localhost:8000/api/v1/sessions/ \
  -H 'content-type: application/json' \
  -d '{"profile_id":"<pid>","folder_id":"<fid>"}'

# 3. drive it
curl -X POST http://localhost:8000/api/v1/browser/sessions/<sid>/action \
  -H 'content-type: application/json' \
  -d '{"action":"navigate","params":{"url":"https://example.com"}}'

# 4. close (auto-closes after 15 min anyway)
curl -X DELETE http://localhost:8000/api/v1/sessions/<sid>

MCP ツール

ストリーミング可能な HTTP MCP クライアントを http://localhost:8000/mcp/ にポイントします。

検出

• list_profiles

• search_profiles

プロファイル管理

• create_profile — 1 つのプロファイルを作成

• create_profiles — 1 回の呼び出しで任意の数のプロファイルを作成（人為的な上限なし）

• remove_profiles

セッション

• launch_session

• session_status

• list_sessions

• close_session

ブラウザ

• browser_action — 名前で任意のアクションを実行

• list_browser_actions — 完全なカタログを表示

完全なアクションカタログには以下が含まれます: navigate、click、type_text、press_key、get_text、get_html、get_url、screenshot、wait_for、evaluate_js、list_tabs、switch_tab、new_tab、close_tab、go_back、go_forward、reload、scroll、hover、select_option、set_checked、upload_file、cookies。

クライアント設定例

{
  "mcpServers": {
    "multilogin-browser": {
      "url": "http://localhost:8000/mcp/"
    }
  }
}

デプロイ

Railway

1. リポジトリをプッシュします。

2. Railway で .env の環境変数を設定します。

3. 開始コマンドを python main.py（または uvicorn app.main:app --host 0.0.0.0 --port $PORT）に設定します。

ランチャーに関する注意

Multilogin デスクトップランチャーは現在 127.0.0.1 に解決されます。リモートホスト（例: Railway）の場合、ランチャーは同じホストで実行するか、トンネル / VPN 経由で到達可能にする必要があります。

ライセンス

MIT