MCP Browser Agent

MCP Browser Agent

site icon
2025.03.25 3
Python浏览器自动化浏览器自动化
MCP Browser Agent 是一个基于模型上下文协议(MCP)的浏览器自动化代理,旨在通过MCP服务器实现Claude与浏览器自动化能力的无缝集成。该项目提供了浏览器交互的自动化功能,包括状态管理、计划执行、交互元素检测和操作等。
View on GitHub

Overview

基本能力

产品定位

MCP Browser Agent 是一个浏览器自动化代理,通过MCP协议实现Claude与浏览器的自动化交互。

核心功能

  • 浏览器自动化
  • 状态管理和计划能力
  • 交互元素检测和操作
  • 可配置的浏览器上下文
  • 日志记录和调试支持

适用场景

  • 自动化测试
  • 数据抓取
  • 网页交互自动化
  • 开发调试

工具列表

  1. get_planner_state: 获取当前浏览器状态和计划上下文
  2. 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

手动安装

  1. 克隆仓库
git clone <repository-url>
cd mcp
  1. 使用uv设置Python环境
uv venv
source .venv/bin/activate
uv sync

调试方式

  • 所有日志都定向到stderr
  • 自定义日志格式:%(levelname)-8s [%(name)s] %(message)s
  • 根记录器级别:INFO
  • 第三方记录器级别:WARNING

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。