Auto Browser

为您的 AI 智能体提供一个真实的浏览器，并实现人机协作。

Auto Browser 是一个用于授权工作流的 MCP 原生浏览器控制平面。它为 MCP 客户端、LLM 智能体和操作员提供了一个共享的 Playwright 浏览器，支持人工接管、可重用的身份验证配置文件、审批、审计追踪以及本地优先部署。

支持：

• Claude Desktop

• Cursor

• 任何支持 HTTP 或 stdio 的 MCP 客户端

• 当您需要 curl 优先控制时的直接 REST 调用者

为什么选择 Auto Browser

• 从第一天起就是 MCP 原生的。 浏览器界面直接封装为 MCP 服务器，而不是事后添加的。

• 当网页变得脆弱时，支持人工接管。 noVNC 确保在需要人工介入时，始终可以使用相同的实时会话。

• 一次登录，后续复用。 保存命名的身份验证配置文件，并重新打开已登录的新会话。

• 默认本地优先。 使用 Docker Compose 在您自己的机器上运行整个堆栈，或使用 Codespaces 进行快速托管演示。

• 内置安全护栏。 审批、操作员身份、PII（个人身份信息）脱敏、见证回执和合规模板都是产品功能的一部分。

Related MCP server: Browser-Use MCP Server

版本亮点 (v1.0.2)

• 框架安全更新，FastAPI 和 Starlette 已锁定在当前的补丁版本线

• 更安全的错误边界，涵盖浏览器操作、CDP、OCR、网格、工作流、隧道、社交和共享令牌界面

• 速率限制加固，使用有界桶和哈希操作员标识符

• 主机和路径策略收紧，针对生产环境的 ALLOWED_HOSTS、身份验证配置文件路径和上传根目录

• 1.0 平台界面，包括签名网格委托、工作流路由、/dashboard、noVNC 接管、MCP 传输、审计追踪和就绪检查

查看 CHANGELOG.md 获取完整的发布历史。

适用场景

• 内部仪表板和管理工具

• 操作员辅助的 QA 和浏览器调试

• 一次登录、后续复用的账户工作流

• 需要人工介入以恢复流程的脆弱网站

• 需要真实浏览器（而非仅 HTML 获取）的 MCP 驱动智能体工作流

非目标场景

• 隐身或反机器人工作

• 验证码破解

• 未经授权的抓取或账户自动化

• 欺骗性身份塑造或绕过工具

您将获得什么

快速入门

git clone https://github.com/LvcidPsyche/auto-browser.git
cd auto-browser
docker compose up --build

这对于使用默认设置进行本地开发已足够。

可选：

cp .env.example .env
make doctor

在具有本地 Docker 访问权限和打开 localhost 套接字权限的普通终端中运行 make doctor。

打开：

• API 文档：http://127.0.0.1:8000/docs

• 操作员仪表板：http://127.0.0.1:8000/dashboard

• 可视化接管：http://127.0.0.1:6080/vnc.html?autoconnect=true&resize=scale

所有已发布的端口默认绑定到 127.0.0.1。

在 Codespaces 中尝试

Codespaces 会自动配置堆栈。仪表板和 noVNC 标签页通常在 90 秒内准备就绪。

第一个实用演示

此仓库中信号最强的流程是：

1. 创建会话

2. 如果网站需要人工，则手动登录

3. 将会话保存为命名的身份验证配置文件

4. 从该配置文件打开新会话

5. 无需重新验证即可继续工作

从这里开始：

• examples/login-and-save-profile.md

• examples/README.md

最小会话创建：

curl -s http://127.0.0.1:8000/sessions \
  -X POST \
  -H 'content-type: application/json' \
  -d '{"name":"demo","start_url":"https://example.com"}' | jq

最小观察：

curl -s http://127.0.0.1:8000/sessions/<session-id>/observe | jq

MCP 客户端

Auto Browser 暴露了：

• http://127.0.0.1:8000/mcp 处的 HTTP MCP 端点

• http://127.0.0.1:8000/mcp/tools 和 http://127.0.0.1:8000/mcp/tools/call 处的便捷端点

• scripts/mcp_stdio_bridge.py 处的捆绑 stdio 网桥

默认的 MCP 工具配置文件是 curated，它保持浏览器界面紧凑，以便更好地进行工具选择。如果您需要完整的内部工具界面，请设置：

MCP_TOOL_PROFILE=full

原始工具调用示例：

curl -s http://127.0.0.1:8000/mcp/tools/call \
  -X POST \
  -H 'content-type: application/json' \
  -d '{
    "name":"browser.create_session",
    "arguments":{
      "name":"demo",
      "start_url":"https://example.com"
    }
  }' | jq

客户端设置指南：

• docs/mcp-clients.md

• examples/claude-desktop-setup.md

• examples/cursor-mcp-setup.md

• examples/claude_desktop_config.json

安全与合规

对于真正的私有部署，至少设置：

APP_ENV=production
API_BEARER_TOKEN=<strong-random-secret>
REQUIRE_OPERATOR_ID=true
AUTH_STATE_ENCRYPTION_KEY=<44-char-fernet-key>
REQUIRE_AUTH_STATE_ENCRYPTION=true
REQUEST_RATE_LIMIT_ENABLED=true
METRICS_ENABLED=true

COMPLIANCE_TEMPLATE 可以在启动时应用预配置的姿态：

所有模板都需要上传审批。HIPAA、SOC2 和 PCI-DSS 还启用了见证回执。启动时会将应用的策略写入 /data/compliance-manifest.json。

示例：

COMPLIANCE_TEMPLATE=HIPAA docker compose up

有关部署详情、托管见证说明、CLI 身份验证模式和反向 SSH 指导，请参阅：

• docs/deployment.md

• docs/production-hardening.md

架构概览

flowchart LR
    User[Human operator] -->|watch / takeover| noVNC[noVNC]
    LLM[OpenAI / Claude / Gemini] -->|shared tools| Controller[Controller API]
    Controller -->|Playwright protocol| Browser[Browser node]
    noVNC --> Browser
    Browser --> Artifacts[(screenshots / traces / auth state)]
    Controller --> Artifacts
    Controller --> Policy[Allowlist + approval gates]

核心组件：

• browser-node/ 运行 Chromium、Xvfb、x11vnc 和 noVNC

• controller/ 暴露 FastAPI 控制器、MCP 传输、策略护栏和编排端点

• data/ 保存运行时工件、身份验证状态、审批、审计日志和可选的 CLI 缓存

• scripts/ 包含用于 doctor、冒烟测试、网桥和发布检查的本地辅助工具

仓库指南

常用命令

文档地图

贡献

如果您想提供帮助，请从以下内容开始：

• CONTRIBUTING.md

• docs/good-first-issues.md

• CODE_OF_CONDUCT.md

如果 Auto Browser 对您有用，点个星标可以帮助其他人找到它。