lyra-browser · 头号协同浏览器 MCP 服务器

技能简介

lyra-browser 是一款专为 AI Agent 设计的"协同浏览器"MCP 服务器（Model Context Protocol）。它在一个真实可见的 Chromium 窗口中驱动浏览器，让 Agent 像人一样浏览、点击、输入，同时人类用户可以随时接管控制——密码、验证码、双因素认证、支付等关键操作由人完成，其它流程交给 Agent。Agent 的每一步操作都会写入只可追加的审计日志（audit trail），确保完全可追溯。

项目基于 Playwright（headful + 持久化 profile）与 FastMCP 构建，任何支持 MCP 的客户端（Claude、Cursor、Cline 等）只需一条配置即可接入。同一服务器在无人值守时也可切换到 headless 模式（如在 Hermes 聊天后端运行），并支持部署到 Cloudflare 边缘网络。

核心能力

• 头号协同（Co-browsing）：Agent 在用户可见窗口中操作，用户可随时打断或接管，避免 Agent 单独完成高风险动作
• 持久登录：基于持久化的 Chromium Profile，cookie / localStorage / session 都跨会话保留，无需每次重新登录
• 审计日志：每一次导航、表单提交、上传、下载都会记录到只可追加日志，便于合规回溯
• MCP 原生接入：通过 FastMCP 暴露 stdio 与 HTTP 两种传输，Claude / Cursor / VS Code / Cline 等即插即用
• headless 模式：无窗口场景自动切换 headless，搭配 Hermes、Cloudflare Workers 等远程架构仍可工作
• 云端部署：提供官方 Cloudflare 集成模板，可在边缘节点以 MCP HTTP 端点形式对外提供

安装配置

1. 通过 PyPI 安装（推荐）：

   pip install lyra-browser
   # 或使用 uv
   uv pip install lyra-browser

2. 在 MCP 客户端（如 Claude Desktop）配置：

   {
   "mcpServers": {
    "lyra-browser": {
      "command": "lyra-browser",
      "args": ["--transport", "stdio"]
    }
   }
   }

3. 从源码运行（用于二次开发）：

   git clone https://github.com/Intrect-io/lyra-browser
   cd lyra-browser
   pip install -e .

使用步骤

1. 首次启动：执行 lyra-browser，会弹出一个 Chromium 窗口，让用户手动登录需要的网站
2. 接入 MCP：在 Claude / Cursor 等客户端调用 lyra-browser 的导航、点击、输入工具
3. 下达任务：例如"打开 Notion，把上周会议纪要整理成新文档"
4. 人类介入：当遇到密码页 / 验证码 / 支付时，Agent 会暂停等待；用户接管完成敏感步骤
5. 审计复盘：任务完成后，从 audit log 复盘 Agent 的每一步操作
6. 远程部署：可选部署到 Cloudflare Worker，对外暴露 MCP HTTP 端点供远程 Agent 使用

适用场景

• Web 自动化测试：让 Claude 自动执行端到端测试，遇到登录态异常时人工接管
• 数据采集 / 报表填写：Agent 抓取 SaaS 后台数据填入 Excel 或 Notion
• 客户支持自动化：Agent 进入客服后台，根据工单内容操作（敏感操作人工）
• AI 编程助手扩展：让 Cursor / Cline 在调试 Web 应用时直接操作真实浏览器
• 跨站点工作流：把分散在多个 SaaS 的操作串成一个 Agent 工作流

适用人群

• AI Agent / LLM 应用开发者（希望给 Agent 装"会看、会点"的浏览器）
• 自动化测试工程师（想用 LLM 替代部分手写脚本）
• SaaS 运营 / 客服团队（希望把后台操作外包给 Agent）
• 安全敏感行业从业者（医疗 / 金融 / 法务，需要审计日志 + 人类接管双保险）

工作原理

lyra-browser 以 MCP 服务器形式运行在用户的本地机器上。Agent 通过 stdio 或 HTTP 发送 MCP 工具调用（导航、点击、键入、上传等），服务器把指令转换成 Playwright API 操作持久化的 Chromium 实例。每次操作都被记录到 SQLite / 文件日志中（含 URL、时间戳、操作类型、目标元素选择器）。当用户在窗口中点击或键入时，Agent 自动让出控制权，避免冲突。

官方链接

• PyPI：https://pypi.org/project/lyra-browser/
• GitHub：https://github.com/Intrect-io/lyra-browser
• Issues：https://github.com/Intrect-io/lyra-browser/issues