Browser Automation Server

🚀 瀏覽器自動化 MCP 服務器

本服務器基於模型上下文協議（MCP），可為 Claude 及其他兼容 MCP 的 AI 助手提供瀏覽器自動化功能。

🚀 快速開始

本服務器可程序化控制網絡瀏覽器，實現截圖捕獲、元素交互、頁面導航、表單填寫和數據提取等功能。以下是啟動服務器的步驟：

# 克隆倉庫
git clone https://github.com/samihalawa/browser-automation-server.git
cd browser-automation-server

# 安裝依賴項
npm install

# 構建服務器
npm run build

# 啟動服務器
npm start

✨ 主要特性

• 網頁自動化：程序化控制網絡瀏覽器
• 截圖捕獲：拍攝網頁頁面的截圖
• 元素交互：點擊、輸入和與網頁元素交互
• 導航：在頁面之間導航並管理瀏覽器狀態
• 表單填寫：自動填寫和提交表單
• 數據提取：從網頁中提取數據

📦 安裝指南

# 克隆倉庫
git clone https://github.com/samihalawa/browser-automation-server.git
cd browser-automation-server

# 安裝依賴項
npm install

# 構建服務器
npm run build

💻 使用示例

基礎用法

將服務器添加到您的 MCP 配置中：

{
  "servers": {
    "browser-automation": {
      "command": "/path/to/node",
      "args": ["/path/to/browser-automation-server/build/index.js"],
      "enabled": true,
      "port": 3008,
      "environment": {
        "NODE_PATH": "/path/to/node_modules",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

高級用法

以下是一些常用工具的使用示例：

1. 導航到指定網站

navigate(url: "https://example.com")

2. 拍攝截圖

screenshot(fullPage: true)

3. 點擊按鈕

click(selector: "#submit-button")

4. 填寫表單

type(selector: "#username", text: "user123")
type(selector: "#password", text: "password123")
click(selector: "#login-button")

5. 提取數據

extract(selector: ".product-title", attribute: "innerText")

可用工具

navigate

導航到指定的 URL。 參數：

• url (string, 必填)：要導航到的 URL
• waitUntil (string, 可選)：導航等待條件。選項：'load', 'domcontentloaded', 'networkidle'。默認值：'load'

screenshot

拍攝當前頁面的截圖。 參數：

• fullPage (boolean, 可選)：是否捕獲整個頁面或僅視口。默認值：false
• path (string, 可選)：保存截圖的路徑。如果未提供，則返回 Base64 編碼的圖像

click

點擊指定元素。 參數：

• selector (string, 必填)：要點擊的元素的 CSS 選擇器
• waitForSelector (boolean, 可選)：是否等待選擇器出現。默認值：true

type

在輸入字段中輸入文本。 參數：

• selector (string, 必填)：輸入元素的 CSS 選擇器
• text (string, 必填)：要輸入的文本
• delay (number, 可選)：按鍵之間的延遲，以毫秒為單位。默認值：0

extract

從頁面中提取數據。 參數：

• selector (string, 必填)：要提取的元素的 CSS 選擇器
• attribute (string, 可選)：要提取的屬性。如果沒有提供，則提取文本內容

evaluate

在瀏覽器上下文中評估 JavaScript。 參數：

• script (string, 必填)：要評估的 JavaScript 代碼
• args (array, 可選)：傳遞到腳本的參數

📚 詳細文檔

要求

• Node.js 14+
• Playwright 用於瀏覽器自動化

📄 許可證

本項目採用 MIT 許可證。