金大哥 - Browser Automation MCP 详情

article

README

🚀 MCP 浏览器代理

MCP 浏览器代理是一个浏览器自动化代理，通过 Model Context Protocol（MCP）实现浏览器交互，能为 Claude 无缝集成浏览器操作能力。该项目在 AGI House MCP 黑客马拉松活动中构建而成。

🚀 快速开始

MCP 浏览器代理可通过 Model Context Protocol（MCP）实现浏览器交互，为 Claude 提供浏览器操作能力。使用前请确保满足系统要求，并按照安装和配置方法进行操作。

✨ 主要特性

浏览器自动化，支持 MCP 工具操作
状态管理和计划能力
交互式元素检测与操作
可配置浏览器上下文
记录和调试支持

📦 安装指南

系统要求

macOS（darwin 24.2.0）
Python 3.12 或更高版本
uv 包管理器
Google Chrome 浏览器（运行任务时请确保浏览器已关闭）

安装方法

使用 Smithery 自动安装

通过 Smithery 自动安装 Claude Desktop 的浏览器自动化代理：

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

📚 详细文档

配置方法

Claude Desktop 配置

创建或修改你的 Claude Desktop 配置文件：

{
  "mcpServers": {
    "browser-use": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/mcp",
        "run",
        "browser-use.py"
      ]
    }
  }
}

请将 /ABSOLUTE/PATH/TO/browser-use 替换为你的项目目录的绝对路径。

浏览器配置

代理预设使用 Google Chrome，默认配置如下：

非无头模式（适用于开发）
窗口大小：1280x1100
禁用安全功能（用于测试）
录屏路径：./tmp/recordings

使用方法

代理提供两个主要工具：

get_planner_state：获取当前浏览器状态和规划上下文
execute_actions：执行已计划的操作在浏览器中

开发信息

日志记录

项目使用 Python 内置的 logging 模块，配置如下：

所有日志输出到标准错误流
自定义格式：%(levelname)-8s [%(name)s] %(message)s
根日志器级别：INFO
第三方日志器级别：WARNING

项目结构

browser-use.py：主入口点和服务器实现
tmp/recordings：浏览器会话录屏文件夹
依赖管理通过 uv 实现

📄 许可证

本项目遵循 MIT 许可证 - 请参阅 LICENSE 文件了解详情。

许可如下：允许任何人免费获取、复制、使用、修改、合并、发布、分发、转授和/或出售软件及其关联文档文件（“软件”），在以下条件下不受限制：

在所有副本或部分副本中保留本版权声明。
不对上述声明进行任何修改。

对于软件中的任何索赔、损害或其他责任，无论因何原因引起或如何产生，在法律允许的最大范围内，作者或版权持有人不承担任何责任。

Browser Automation