Multilogin 浏览器 MCP

一个基于 FastAPI 的服务，通过 CDP 驱动 Multilogin X 反检测浏览器配置文件，并通过可流式传输的 HTTP MCP 服务器将其暴露给 AI 代理。

功能特性

• 配置文件管理 — 列出、搜索、创建和删除 Multilogin 配置文件（支持批量创建，无人为限制）。

• 浏览器会话 — 启动配置文件，通过 CDP 连接 Playwright，并管理会话生命周期。

• 浏览器操作目录 — 导航、点击、输入、执行 JS、截图、标签页、Cookie、滚动、悬停等。

• 双接口 — 面向集成的 REST API 和面向代理框架的 MCP。

• 会话看门狗 — 15 分钟最大 TTL 和空闲超时清理。

• 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 — 我们通过 CDP 连接到 Multilogin 启动的浏览器。

配置

复制示例并填写相应值：

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 — 创建一个配置文件

• create_profiles — 一次调用创建任意数量的配置文件（无人为限制）

• 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