🚀 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

手动安装

1. 克隆仓库：

git clone <repository-url>
cd mcp

2. 使用 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

使用方法

代理提供两个主要工具：

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

开发信息

日志记录

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

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

项目结构

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

📄 许可证

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

版权 © 2025 Jaeyun Ha, Ashley Ha

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

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

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