MCP Browser Agent

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

<a href="https://glama.ai/mcp/servers/@ashley-ha/mcp-manus"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=1999978762,2457418392&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Browser Agent MCP 服务器" /> </a>

概述

该项目是一个浏览器自动化代理，它使用模型上下文协议（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

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

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

软件按“原样”提供，不附带任何形式的保证，包括但不限于适销性、特定用途适用性和非侵权性的默示保证。在任何情况下，作者或版权持有人都不对因软件或其使用或其他交易而引起的任何索赔、损害或其他责任承担任何责任，无论是合同行为、侵权行为还是其他行为。