浏览器自动化工具集

浏览器使用mcpplus

此存储库包含包装脚本和小型 MCP 服务器，可通过 DevTools 协议 （CDP） 可靠地启动/查找本地 Chrome/Chromium 实例，然后通过 MCP 使用：

• mcp-plus （Unified MCP: 代理服务器） browser-use/ui-describe/chrome-devtools +Context7+Docker运行程序）
• agent-s3-vm （Agent S3 的 Docker“VM”自测/任务运行器）
• browser-use （上游 browser_use.mcp 通过Python）
• ui-describe （截图 → 通过Vision-LLM进行文本描述，包括叠加清理）
• chrome-devtools （网络/控制台/性能/通过CDP进行JS评估）

结构

• bin/输入点（由您的 MCP 客户端调用）
• lib/：共享Shell Libs
• mcp_plus/：Python辅助模块（stdio客户端、夹具服务器）
• servers/：Python MCP服务器(ui_describe, chrome-devtools)
• scripts/例子/Runner
• tests/多部分本地测试套件
• 运行时状态：默认情况下 $XDG_STATE_HOME/browser-use-mcp-plus/ （订单 ~/.local/state/browser-use-mcp-plus/)

设置（库尔茨）

1. 请确保 google-chrome （订单 CHROME_BIN）可用，并且可以使用CDP。
2. 确保您的 Python 解释器具有依赖关系 （browser_use, mcp等等）。
   • 设置为 BROWSER_USE_MCP_PYTHON=/pfad/zum/python （例如，一个 venv），这样包装器就不会被硬编码。
3. 配置您的 MCP 客户端，以便将包装器放入 bin/ 起动。

没有秘密的例子：

• 多服务器（传统）： examples/claude.mcpServers.example.json
• 统一（推荐）： examples/claude.mcpServers.unified.example.json

快速入门

• Example （打开本地 Fixture 页面，通过 browser-use描述通过 ui-describe，eval via chrome-devtools):
  • bin/mcp_plus.sh example
• 测试套件（mehrere测试；烟雾+覆盖清理+控制台/网络+保持打开）：
  • bin/mcp_plus.sh test

更多文档：

• docs/CONFIGURATION.md
• docs/TESTING.md
• docs/TROUBLESHOOTING.md

重要的Env变量

• BROWSER_USE_MCP_PYTHON所有包装程序的 Python 可执行文件（默认： python3)
• BROWSER_USE_MCP_STATE_DIR：根运行时状态（会话/PID/日志）；违约： ~/.local/state/browser-use-mcp-plus
• BROWSER_USE_CHROME_MODE: session （默认）| persistent | auto
• CHROME_BIN：铬/铬二元合金（默认值： google-chrome)
• CDP_HOST / CDP_PORT持久模式的主机/端口（默认： 127.0.0.1:9222)

安全

此 repo 有意识地包含 无 代币/钥匙。只在 MCP 客户端配置/秘密存储中存储秘密，而不要提交它们。