ashley-ha
服务介绍
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 的浏览器自动化代理：
bash
npx -y @smithery/cli install @ashley-ha/mcp-manus --client claude
手动安装
-
克隆仓库：
bash
git clone
cd mcp -
使用
uv设置 Python 环境：
bash
uv venv
source .venv/bin/activate
uv sync
配置
Claude Desktop 配置
创建或修改您的 Claude Desktop 配置文件：
json
{
"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 工具进行浏览器自动化
- 状态管理和规划能力
- 交互元素检测和操作
- 可配置的浏览器上下文
- 日志记录和调试支持
使用
代理提供了两个主要工具：
get_planner_state：检索当前浏览器状态和规划上下文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
在此授予任何人免费获得此软件及其相关文档文件（“软件”）副本的权利，不受限制地处理该软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利，并允许向其提供软件的人这样做，但须遵守以下条件：
上述版权声明和此许可声明应包含在软件的所有副本或重要部分中。
软件按“原样”提供，不附带任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有者均不对因使用或无法使用软件而引起的任何索赔、损害或其他责任负责，无论是合同诉讼、侵权行为还是其他原因。
