MCP Browser

基本能力

产品定位

MCP Browser 是一个无头浏览器接口，主要用于浏览器自动化操作，支持与 MCP 集成，适用于 AI 代理等场景。

核心功能

• 使用 Playwright 进行无头浏览器自动化
• 提供 Web UI 用于浏览器交互
• 支持 WebSocket 通信，实现实时更新
• 实时浏览器事件订阅系统
• 与 MCP 集成，支持 AI 代理

适用场景

• 浏览器自动化测试
• 网页数据抓取
• AI 代理的浏览器交互
• 实时监控网页事件

工具列表

• Playwright: 用于无头浏览器自动化
• WebSocket: 用于实时通信和事件订阅
• Docker: 支持容器化部署

常见问题解答

• XQuartz 问题: 安装时需要 XQuartz (X11) 支持，如果自动启动失败，需手动启动。
• 依赖问题: 确保 Python 3.13+ 和 uv 已安装。

使用教程

使用依赖

• Python 3.13+
• uv 用于依赖管理
• Docker（用于容器化使用）

安装教程

一键安装

curl -sSL https://raw.githubusercontent.com/neoforge-dev/mcp-browser/main/install_one_line.sh | bash

手动安装

git clone https://github.com/neoforge-dev/mcp-browser.git
cd mcp-browser
./install.sh

XQuartz 要求

安装程序会自动检查并安装 XQuartz，如果自动启动失败，需手动启动。

本地开发

使用 uv 设置

git clone https://github.com/yourusername/mcp-browser.git
cd mcp-browser
uv venv .venv
source .venv/bin/activate
uv pip install -e .
python -m playwright install

运行测试

./simple_test.sh

或

./test_local.sh

Docker 部署

export MCP_SECRET=your_secret_key
docker-compose up --build

或

./run.sh

调试方式

• 检查 XQuartz 是否正常运行
• 确保依赖已正确安装
• 使用 ./simple_test.sh 或 ./test_local.sh 进行测试

许可证

该项目遵循 MIT 开源许可条款。