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

用法

1. 启动服务器：

python server.py

服务器将在 http://localhost:8000 上启动。

API 接口

创建新会话

POST /session/create
Response: { "session_id": "..." }

导航到 URL

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

截取屏幕截图

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

如果未提供 selector，则截取完整页面屏幕截图。

点击元素

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

Python 示例用法

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())

许可证

MIT