MCP 浏览器代理

在 AGI House MCP 黑客马拉松上构建

概述

本项目是一个浏览器自动化代理，它使用模型上下文协议 (MCP) 来实现浏览器交互。它通过我们的 MCP 服务器提供 Claude 和浏览器自动化功能之间的无缝集成。

感谢 Browser-Use 提供的浏览器代理功能，它为我们的 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

特性

• 通过 MCP 工具进行浏览器自动化
• 状态管理和规划能力
• 交互式元素检测和操作
• 可配置的浏览器上下文
• 日志记录和调试支持

用法

该代理提供两个主要工具：

1. get_planner_state: 检索当前浏览器状态和规划上下文
2. execute_actions: 在浏览器中执行计划的操作

开发

日志记录

该项目使用 Python 的内置日志记录，具有以下配置：

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

项目结构

• browser-use.py: 主要入口点和服务器实现
• tmp/recordings: 浏览器会话录制目录
• 依赖项通过 uv 管理

贡献

本项目是在 AGI House MCP 黑客马拉松期间构建的。 欢迎贡献！

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

版权所有 (c) 2025 Jaeyun Ha, Ashley Ha

特此授予任何获得本软件和相关文档文件（“软件”）副本的人员免费许可，可以不受限制地处理本软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件的副本，并允许向其提供本软件的人员这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或重要部分中。

本软件按“原样”提供，不提供任何形式的明示或暗示的保证，包括但不限于适销性、特定用途的适用性和不侵权的保证。 在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论是在合同诉讼、侵权诉讼或其他诉讼中，因本软件或本软件的使用或其他处理而引起的或与之相关的。