Browser Automation

🚀 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. 不對上述聲明進行任何修改。

對於軟件中的任何索賠、損害或其他責任，無論因何原因引起或如何產生，在法律允許的最大範圍內，作者或版權持有人不承擔任何責任。