
MCP Browser Agent

2025.03.25
3
Python浏览器自动化浏览器自动化
MCP Browser Agent 是一个基于模型上下文协议(MCP)的浏览器自动化代理,旨在通过MCP服务器实现Claude与浏览器自动化能力的无缝集成。该项目提供了浏览器交互的自动化功能,包括状态管理、计划执行、交互元素检测和操作等。
View on GitHub
Overview
基本能力
产品定位
MCP Browser Agent 是一个浏览器自动化代理,通过MCP协议实现Claude与浏览器的自动化交互。
核心功能
- 浏览器自动化
- 状态管理和计划能力
- 交互元素检测和操作
- 可配置的浏览器上下文
- 日志记录和调试支持
适用场景
- 自动化测试
- 数据抓取
- 网页交互自动化
- 开发调试
工具列表
get_planner_state
: 获取当前浏览器状态和计划上下文execute_actions
: 在浏览器中执行计划的操作
常见问题解答
- 确保在运行任务前关闭Google Chrome浏览器
- 需要正确配置Claude Desktop的配置文件
使用教程
使用依赖
- macOS (darwin 24.2.0)
- Python 3.12或更高版本
uv
包管理器- Google Chrome浏览器
安装教程
通过Smithery安装
npx -y @smithery/cli install @ashley-ha/mcp-manus --client claude
手动安装
- 克隆仓库
git clone <repository-url>
cd mcp
- 使用
uv
设置Python环境
uv venv
source .venv/bin/activate
uv sync
调试方式
- 所有日志都定向到stderr
- 自定义日志格式:
%(levelname)-8s [%(name)s] %(message)s
- 根记录器级别:INFO
- 第三方记录器级别:WARNING