MCP Browser Agent

MCP浏览器代理

建在AGI House MCP黑客马拉松上

概述

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

感谢Browser Use的浏览器代理功能为我们的MCP服务器供电！

系统要求

• macOS（达尔文24.2.0）
• Python 3.12或更高版本
• uv 包管理器
• 谷歌Chrome浏览器（在运行任务之前，请确保您的浏览器已关闭。)

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面浏览器自动化代理 史密瑟里:

npx -y @smithery/cli install @ashley-ha/mcp-manus --client claude

手动安装

1. 克隆存储库：

git clone 
cd mcp

1. 使用以下命令设置Python环境 uv:

uv venv
source .venv/bin/activate
uv sync

配置

Claude桌面配置

创建或修改您的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/录制

特性

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

用法

代理提供两个主要工具：

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

发展

日志记录

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

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

项目结构

• browser-use.py：主要入口点和服务器实现
• tmp/recordings：浏览器会话录制目录
• 通过以下方式管理依赖关系 uv

贡献

该项目是在AGI House MCP黑客马拉松期间建造的。欢迎投稿！

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

版权所有（c）2025哈载云

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

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

软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易而产生或与之相关的任何索赔、损害赔偿或其他责任承担责任，无论是在合同、侵权或其他诉讼中。