MCP Browser Automation Server

🚀 MCP 瀏覽器自動化服務器

MCP 瀏覽器自動化服務器是一款簡單卻功能強大的工具，它允許用戶通過 REST API 對瀏覽器進行控制，還能截取屏幕截圖，並且可以即時監控控制檯日誌，為自動化測試和網頁操作提供了極大便利。

🚀 快速開始

MCP 瀏覽器自動化服務器能讓你輕鬆通過 REST API 控制瀏覽器，實現截圖、監控日誌等功能。以下是使用前的準備步驟。

✨ 主要特性

• 創建會話
• 導航到 URL
• 截取屏幕截圖（全頁或特定元素）
• 點擊元素
• 填充表單輸入
• 通過 WebSocket 即時監控控制檯日誌
• 關閉會話

📦 安裝指南

1. 克隆此倉庫：

git clone https://github.com/weir1/mcp-browser-automation.git
cd mcp-browser-automation

2. 創建虛擬環境並激活：

python -m venv venv
.\venv\Scripts\Activate

3. 安裝依賴項：

pip install -r requirements.txt

4. 安裝 Playwright 瀏覽器：

playwright install

💻 使用示例

基礎用法

啟動服務器：

python server.py

服務器將在 http://localhost:8000 上運行。

高級用法

以下是使用 Python 調用 API 的示例代碼，展示了創建會話、導航、截圖和監控日誌等操作：

import requests
import websockets
import asyncio
import json

# 創建一個會話
response = requests.post("http://localhost:8000/session/create")
session_id = response.json()["session_id"]

# 導航到 URL
requests.post(f"http://localhost:8000/session/{session_id}/navigate?url=https://example.com")

# 截取屏幕截圖
response = requests.post(f"http://localhost:8000/session/{session_id}/screenshot?name=example")
with open("screenshot.png", "wb") as f:
    f.write(response.content)

# 監控控制檯日誌
async def monitor_console():
    async with websockets.connect(f"ws://localhost:8000/session/{session_id}/console") as ws:
        while True:
            message = await ws.recv()
            print(json.loads(message))

asyncio.get_event_loop().run_until_complete(monitor_console())

📚 詳細文檔

API 端點

創建新會話

POST /session/create
響應：{ "session_id": "..." }

導航到 URL

POST /session/{session_id}/navigate?url=https://example.com

截取屏幕截圖

POST /session/{session_id}/screenshot?name=screenshot1&selector=.my-element

如果未提供選擇器，則截取全頁屏幕截圖。

點擊元素

POST /session/{session_id}/click?selector=.my-button

填充表單輸入

POST /session/{session_id}/fill?selector=input[name="username"]&value=myuser

監控控制檯日誌

WebSocket /session/{session_id}/console

關閉會話

POST /session/{session_id}/close

📄 許可證

本項目採用 MIT 許可證。