Which integrations are available for this server?

Provides full control over Linux systems through shell command execution and Python scripts, enabling tasks such as system maintenance, process management, and file system operations.

How do I use Arche Browser?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Arche Browser Open news.ycombinator.com and summarize the top three stories." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

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

Arche Browser

Arche Browser

Features

Design Philosophy

Installation

Usage

Browser Only (Default)

Full PC Control

PC Control Only (No Browser)

Remote Access (SSE)

Local Control Tools

Core Primitives

Convenience Tools

What You Can Do

Browser Tools

Navigation

DOM & Input

Screenshots & PDF

Cookies & Storage

JavaScript

CLI Options

Architecture

Security

Requirements

License

Resources

Looking for Admin?

Appeared in Searches

Latest Blog Posts

MCP directory API