alchaincyf/huashu-chrome

解决的问题

它解决了 AI 代理通常在隔离的“干净”浏览器会话中运行，无法访问您现有的登录状态、Cookie 或个人浏览器历史记录的局限性。它允许任何兼容 MCP 的 AI 代理控制您日常使用的实际 Chrome 浏览器，从而执行填写表单、与已认证的仪表板交互或从您已登录的网站抓取数据等任务。

工作原理

它作为 AI 代理和浏览器之间的桥梁，采用五部分架构：一个 npm 包、一个 CLI、一个 MCP 服务器、一个本地桥接进程和一个 Chrome 扩展。当您发出命令时，代理通过 MCP 服务器与本地桥接进程通信，然后桥接进程将指令中继到 Chrome 扩展。扩展充当与浏览器交互的“手”，为代理提供页面的结构化快照（使用带引用编号的元素）并执行操作。它内置了超过 20 个网站的“站点知识”，帮助代理避免常见陷阱，并允许代理在本地学习和保存特定于站点的模式。

适用人群

该项目面向使用 AI 编码代理（如 Claude Code、Cursor、Cline 或 Windsurf）的高级用户和开发人员，他们希望自动化需要身份验证的基于浏览器的工作流程，例如 CRM 数据录入、管理云控制台或与内部 Web 工具交互。

亮点

• 真实登录持久性： 直接在您活动的 Chrome 浏览器中运行，意味着无需重新认证或处理复杂的登录流程。
• 验证优先的操作： 每次写入操作都要求代理报告页面更改的证据；如果页面没有按预期响应，代理会停止以防止级联错误。
• 站点特定智能： 附带超过 20 个热门站点的预配置“经验”笔记，并允许代理在本地保存新发现以改进未来性能。
• 安全优先设计： 在 LLM 之外实施安全措施，例如代理无法绕过的强制支付确认 UI，以及自动敏感数据编辑。
• 广泛兼容性： 自动检测并配置超过 20 个热门 AI 代理和 CLI 工具的 MCP 设置。