How do I use xiaozhi-bridge?

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., "@xiaozhi-bridge open google.com in the browser" 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.

xiaozhi-bridge

by weemadscotsman

Overview Schema Related Servers Score Discussions

JavaScript

Local

🦞 PURPCLAW v7.0 — ULTIMATE

The AI Voice Agent MCP Bridge — Gives your Xiaozhi AI hardware full autonomous PC control via 58 MCP tools. Built by WEEMADSCOTSMAN at Pixel Dynasty.

🚀 New Here? Read the Full Setup Guide →

The setup guide covers everything from buying the hardware to your first voice command. Anyone with a Xiaozhi ball can use this.

What Is This?

PURPCLAW is an MCP (Model Context Protocol) bridge that connects a Xiaozhi AI voice agent to your Windows PC. It turns a voice-enabled AI ball into a fully autonomous engineering assistant that can:

🖥️ See your screen — Screenshots + OCR text recognition
📸 See YOU — Webcam capture, face/object detection
🌐 Browse the web — Playwright-powered: click links, fill forms, read pages
📁 Manage files — Read, write, copy, move, delete, search, zip/extract
🖱️ Control your desktop — Mouse clicks, keyboard typing, window management
⬇️ Download files — Direct URL downloads
📦 Install packages — pip, npm, or choco
🔊 Control audio — Volume up/down/mute/set
🔧 Run commands — Shell execution with injection protection
🧠 Remember things — Persistent memory across sessions
🦞 Run AI pipelines — Start/stop/monitor PURPCLAW build pipelines

Related MCP server: Windows MCP Server

Architecture

┌──────────────────┐     WebSocket      ┌──────────────────┐
│   Xiaozhi Ball   │ ◄──────────────── │  xiaozhi_bridge   │
│  (DeepSeek V3.1) │   MCP Protocol    │     v7.0.0        │
└──────────────────┘                   └────────┬─────────┘
                                                │
                              ┌─────────────────┼─────────────────┐
                              │                 │                 │
                        ┌─────┴─────┐   ┌──────┴──────┐   ┌─────┴─────┐
                        │ Playwright │   │ PowerShell  │   │  Python   │
                        │  Browser   │   │  .NET APIs  │   │  OpenCV   │
                        └───────────┘   └─────────────┘   └───────────┘

58 MCP Tools

Vision (5)

Tool	Description
`screen_capture`	Screenshot the screen
`screen_ocr`	Read text from screen via OCR
`screen_find_object`	Detect objects with YOLO
`screen_find_template`	Find image on screen (template match)
`screen_info`	Get monitor sizes

Webcam (3)

Tool	Description
`webcam_look`	Take a photo with PC webcam
`webcam_detect`	Detect people/faces/objects
`webcam_read`	OCR text visible to camera

Mouse & Keyboard (3)

Tool	Description
`mouse_click`	Click, double-click, right-click, drag
`mouse_scroll`	Scroll wheel
`keyboard_type`	Type text or press shortcuts

UI Automation (1)

Tool	Description
`find_and_click`	Find and click UI elements by text

Window Management (3)

Tool	Description
`window_list`	List open windows
`window_focus`	Focus a window by title
`window_close`	Close a window

File System (8)

Tool	Description
`file_read`	Read file contents
`file_write`	Write/append to files
`file_list`	List directory contents
`file_search`	Search by name or content (Node.js, fast)
`file_copy`	Copy files/directories
`file_move`	Move/rename files
`file_delete`	Delete files (system path protected)
`dir_create`	Create directories

Browser (9) — Playwright-Powered

Tool	Description
`browser_open`	Open URL with full interaction
`browser_click`	Click links/buttons by visible text
`browser_type`	Type into form fields
`browser_scroll`	Scroll pages up/down
`browser_get_content`	Read page text content
`browser_screenshot`	Screenshot the browser
`browser_navigate`	Navigate: goto/back/forward/reload
`browser_tabs`	List open tabs
`browser_close_tab`	Close a tab

Downloads (1)

Tool	Description
`download_file`	Download file from URL

Process Management (2)

Tool	Description
`process_list`	List running processes
`process_kill`	Kill process by name/PID (critical procs blocked)

Audio (1)

Tool	Description
`volume_control`	Set volume, mute/unmute, up/down

Archives (2)

Tool	Description
`zip_create`	Create zip archives
`zip_extract`	Extract zip archives

Package Management (1)

Tool	Description
`install_package`	Install via pip/npm/choco

PURPCLAW Pipeline (4)

Tool	Description
`purpclaw_start`	Start AI build pipeline
`purpclaw_stop`	Stop pipeline
`purpclaw_status`	Get pipeline status
`purpclaw_logs`	Read pipeline logs

Git (1)

Tool	Description
`git_command`	Run git commands

Communication (4)

Tool	Description
`http_request`	HTTP GET/POST/PUT/DELETE
`clipboard`	Read/write clipboard
`speak`	Text-to-speech via Kokoro TTS
`notification`	Desktop toast notifications

Context & System (5)

Tool	Description
`active_window`	Get focused window info
`system_status`	CPU, RAM, process overview
`disk_info`	Drive space for all disks
`network_info`	IP, WiFi, internet status
`execute_command`	Execute shell commands (injection-proof)

Apps & Tasks (4)

Tool	Description
`open_application`	Launch apps by name
`memory`	Persistent remember/recall/forget/list
`task_schedule`	Schedule delayed tasks
`task_list`	List scheduled tasks

Setup

Prerequisites

Node.js 18+
Python 3.10+ with opencv-python
Playwright (npm i playwright)
Xiaozhi.me account + configured agent

Install

git clone https://github.com/weemadscotsman/purpclaw.git
cd purpclaw
npm install
cp .env.example .env
# Edit .env with your Xiaozhi MCP token

Run

# Windows (recommended)
start_xiaozhi_bridge.bat

# Or manually
set XIAOZHI_MCP_URL=wss://api.xiaozhi.me/mcp/?token=YOUR_TOKEN
node lib/xiaozhi_bridge.js

Environment Variables

Variable	Description
`XIAOZHI_MCP_URL`	WebSocket URL from Xiaozhi MCP settings
`OPENCLAW_GATEWAY`	OpenClaw WebSocket (default: `ws://127.0.0.1:18789`)
`MCP_BRIDGE_URL`	Bridge HTTP server (default: `http://localhost:3001`)

Security

Shell injection protection — All user input is sanitized via san() function
System path protection — Cannot delete Windows/Program Files/AppData
Critical process protection — Cannot kill explorer, csrss, lsass, svchost
Destructive command blocking — Blocks format, recursive system deletes, shutdown
Tool timeout — Every tool has a timeout to prevent hanging

Tech Stack

Runtime: Node.js (single-process, async event loop)
Browser: Playwright (Chromium, headless: false)
Vision: Python OpenCV + Haar cascade face detection
Screen: .NET System.Drawing (fast screenshot via PowerShell)
Shell: PowerShell -NoProfile -NonInteractive (fast startup)
Protocol: MCP over WebSocket (JSON-RPC 2.0)

Built With

Created by Eddie Cannon (@weemadscotsman) — Edinburgh, Scotland 🏴󠁧󠁢󠁳󠁣󠁴󠁿

Pixel Dynasty — Gaming Archive & Collab Hub
NDK Threads — ndkthreads.com
PixelBits420 — Fair-launch cryptocurrency

License

MIT

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Windows-MCP
Shell Access Open Data
StepByStep-1
A
license
-
quality
D
maintenance
Enables AI agents to interact with Windows operating systems through native UI automation, file navigation, application control, and system commands. Provides seamless integration between LLMs and Windows environments for tasks like clicking, typing, launching apps, and capturing desktop state.
Last updated 2025-08-16
MIT
Windows MCP Server
OS Automation App Automation
RandyNorthrup
A
license
-
quality
A
maintenance
Enables comprehensive Windows desktop automation including screen capture, OCR text extraction, mouse/keyboard control, window management, process control, and clipboard operations through 25+ tools for AI agents.
Last updated 2026-07-06
3
MIT
mcp-windows-server
OS Automation Browser Automation
mukul975
A
license
-
quality
D
maintenance
Enables AI assistants to control Windows systems through natural language commands, providing 200+ automation tools for system control, file operations, web automation, and more.
Last updated 2026-06-03
44
MIT
WinCommander
Shell Access Browser Automation OS Automation
Chaiyuhao
F
license
-
quality
B
maintenance
Turns any Windows device into a remotely controllable MCP toolset, allowing a mobile AI agent to execute CLI, GUI, browser, and system commands on Windows without an API key.
Last updated 2026-07-05
1

View all related MCP servers

Related MCP Connectors

Pangolinfo MCP for Agent
Real-time Amazon, search and market intelligence tools for AI agents via remote MCP.
Sayba AI Agent Social Platform
AI Agent social network with 23 MCP tools for social, tasks, skills, and XC token economy.
Frenchie
OCR, transcription, file extraction, and image generation for AI agents via MCP.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/weemadscotsman/xiaozhi-bridge'

If you have feedback or need assistance with the MCP directory API, please join our Discord server