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
--localflag - 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