MCP Browser Automation Server

🚀 MCP Browser Automation Server

A simple yet powerful browser automation server that allows you to control browsers, take screenshots, and monitor console logs in real-time via REST API.

🚀 Quick Start

The MCP Browser Automation Server is a tool that enables you to automate browser operations through a REST API. You can control browsers, capture screenshots, and monitor console logs in real - time.

✨ Features

• Create a session.
• Navigate to a URL.
• Take screenshots (full - page or of a specific element).
• Click on an element.
• Fill out form inputs.
• Monitor console logs in real - time via WebSocket.
• Close a session.

📦 Installation

1. Clone this repository:

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

2. Create and activate a virtual environment:

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

3. Install dependencies:

pip install -r requirements.txt

4. Install the Playwright browser:

playwright install

💻 Usage Examples

Basic Usage

1. Start the server:

python server.py

The server will run on http://localhost:8000.

Advanced Usage

Here are some API endpoints and example usages:

API Endpoints

• Create a new session

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

• Navigate to a URL

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

• Take a screenshot

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

If no selector is provided, a full - page screenshot will be taken.

• Click on an element

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

• Fill out form inputs

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

• Monitor console logs

WebSocket /session/{session_id}/console

• Close a session

POST /session/{session_id}/close

Python Example

import requests
import websockets
import asyncio
import json

# Create a session
response = requests.post("http://localhost:8000/session/create")
session_id = response.json()["session_id"]

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

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

# Monitor console logs
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())

📄 License

MIT