arche-browser by GizAI - MCP Server

Arche Browser

MCP Server for Browser Automation and Full Local PC Control.

Control a real Chrome browser AND your entire computer from Claude Code or any MCP client.

Features

Full Browser Control: Navigation, clicks, typing, screenshots, and more
Full PC Control: Shell commands, Python execution, file system, clipboard, processes
Real Browser: Uses your actual Chrome with cookies, extensions, login sessions
Remote Access: Control browser/PC on any machine via SSE transport
Token Authentication: Secure remote access with auto-generated tokens
Minimal Design: Just a few powerful primitives that can do anything

Design Philosophy

Inspired by Eric Gamma's principles: Simple, Flexible, Powerful

Instead of hundreds of specific tools, Arche provides a few powerful primitives:

Primitive	What it does	What you can achieve
`shell()`	Execute any shell command	Volume, reboot, programs, services, ANYTHING
`python_exec()`	Execute Python code	Camera, Excel, AI, complex logic, ANYTHING
`screen_capture()`	Desktop screenshot	Visual feedback for AI

With just shell and python_exec, AI can literally control EVERYTHING on your computer.

Installation

# From PyPI
pip install arche-browser

# From GitHub
pip install git+https://github.com/GizAI/arche-browser.git

# One-liner (no install)
uvx arche-browser

Usage

Browser Only (Default)

arche-browser

Claude Code config:

{"mcpServers": {"browser": {"command": "arche-browser"}}}

Full PC Control

arche-browser --local

Claude Code config:

{"mcpServers": {"arche": {"command": "arche-browser", "args": ["--local"]}}}

PC Control Only (No Browser)

arche-browser --local --no-browser

Remote Access (SSE)

On the machine with Chrome:

arche-browser --sse --port 8080 --local

# Output:
# [*] Auth: ENABLED
# [*] Token: abc123...
# [*] Connect URL: http://localhost:8080/sse?token=abc123...

On Claude Code:

{"mcpServers": {"remote": {"url": "http://YOUR_IP:8080/sse?token=YOUR_TOKEN"}}}

Local Control Tools

Core Primitives

Tool	Description
`shell(command)`	Execute shell command (bash/cmd/powershell)
`python_exec(code)`	Execute Python code with full system access
`screen_capture(path)`	Capture desktop screenshot

Convenience Tools

Tool	Description
`file_read(path)`	Read file content
`file_write(path, content)`	Write file content
`file_list(path, pattern)`	List directory contents
`file_delete(path)`	Delete file or directory
`file_copy(src, dst)`	Copy file or directory
`file_move(src, dst)`	Move/rename file or directory
`clipboard_get()`	Get clipboard content
`clipboard_set(content)`	Set clipboard content
`system_info()`	Get OS, CPU, memory, disk info
`process_list()`	List running processes
`process_kill(pid/name)`	Kill a process

What You Can Do

# Volume control (Windows)
shell("powershell (Get-AudioDevice -Playback).SetMute($false)")

# Take a photo with webcam
python_exec("""
import cv2
cap = cv2.VideoCapture(0)
ret, frame = cap.read()
cv2.imwrite("photo.jpg", frame)
cap.release()
""")

# Create Excel spreadsheet
python_exec("""
import openpyxl
wb = openpyxl.Workbook()
ws = wb.active
ws['A1'] = 'Sales Report'
ws['A2'] = 1000
wb.save('report.xlsx')
""")

# System maintenance
shell("cleanmgr /d C:")  # Windows disk cleanup
shell("sudo apt autoremove")  # Linux cleanup

# Reboot computer
shell("shutdown /r /t 60")  # Windows
shell("sudo reboot")  # Linux

# Kill a program
process_kill(name="notepad.exe")

Browser Tools

Navigation

Tool	Description
`goto(url)`	Navigate to URL
`get_url()`	Get current URL
`get_title()`	Get page title
`reload()`	Reload page
`go_back()`	Go back in history
`go_forward()`	Go forward in history

DOM & Input

Tool	Description
`get_text(selector)`	Get element text
`get_html(selector)`	Get element HTML
`click(selector)`	Click element
`type_text(selector, text)`	Type into input
`select_option(selector, value)`	Select dropdown
`check_box(selector, checked)`	Check/uncheck
`scroll_to(x, y)`	Scroll page

Screenshots & PDF

Tool	Description
`screenshot(path)`	Take screenshot
`pdf(path)`	Generate PDF

Cookies & Storage

Tool	Description
`get_cookies()`	Get cookies
`set_cookie(name, value)`	Set cookie
`storage_get(key)`	Get localStorage
`storage_set(key, value)`	Set localStorage

JavaScript

Tool	Description
`evaluate(script)`	Execute JS

CLI Options

arche-browser [OPTIONS]

Mode:
  --local          Enable full local PC control
  --no-browser     Disable browser tools (requires --local)

Transport:
  --sse            Run as SSE server for remote access
  --port PORT      SSE server port (default: 8080)

Browser:
  --headless       Run Chrome in headless mode

Authentication:
  --no-auth        Disable token authentication
  --token TOKEN    Use specific auth token
  --show-token     Show current auth token
  --reset-token    Generate new auth token

Architecture

arche_browser/
├── __init__.py    # Package exports
├── __main__.py    # CLI entry point
├── chrome.py      # Chrome process management
├── browser.py     # Full CDP browser automation
├── server.py      # MCP server with all tools
├── auth.py        # Token authentication
├── local.py       # Local PC control primitives
└── sites/
    └── chatgpt.py # ChatGPT-specific client

Security

Token Authentication: Remote SSE servers require authentication by default
Explicit Opt-in: Local PC control requires --local flag
No Sandbox: Local control has NO restrictions - use responsibly

Requirements

Python 3.10+
Chrome, Chromium, or Edge browser (for browser tools)
MCP client (Claude Code, etc.)

License

MIT