Skip to main content
Glama
deenesjakoruzh
Joho6666

XiaoZhi Windows MCP Agent Bridge

by Joho6666
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

XiaoZhi Windows MCP Agent Bridge

Der XiaoZhi Windows MCP Agent Bridge ist ein Brückendienst, der ESP32 XiaoZhi AI-Geräte mit Mikrofon und Lautsprecher auf dem Schreibtisch mit einem lokalen Windows-Computer verbindet.

Über das standardmäßige Model Context Protocol (MCP) kann XiaoZhi als Sprachkommandant (Voice Commander) fungieren, lokale Windows-Tools aufrufen, Computeroperationen ausführen, Dateien auf der gesamten Festplatte lesen und schreiben, den Edge-Browser steuern, Bildschirmaufnahmen für visuelle Analysen machen und vor allem die lokale Codex CLI / Claude Code / OpenCode AI-Agenten-Matrix orchestrieren, um schwere Entwicklungs- und Engineering-Aufgaben auszuführen.

Gesamtarchitektur: Sprachkommandant + lokale Agenten-Matrix

小智 ESP32 硬件 (麦克风/喇叭/屏幕)
       ↓ (语音交互)
 xiaozhi.me 官方云端 (ASR / LLM / TTS / MCP Client)
       ↓ (WebSocket JSON-RPC 2.0)
 XiaoZhi Windows Agent Bridge (本机 Python 进程)
       ↓
  Tool Registry (注册 49 个本地能力工具)
       ↓
┌─────────────────┬─────────────────┬─────────────────┬─────────────────┐
│ Windows 应用    │ 本地文件系统    │ 终端与 PowerShell│ 多 Agent 调遣器 │
│ • 智能启动/搜索 │ • 全盘/目录遍历 │ • Safe Terminal │ • Codex CLI 主力│
│ • 进程聚焦/退出 │ • 文件读写/删除 │ • 任意 Shell    │ • Claude / Open │
├─────────────────┼─────────────────┼─────────────────┼─────────────────┤
│ Desktop GUI     │ 屏幕视觉 (Vision│ Edge 浏览器     │ Skills/Workflow │
│ • 窗口枚举/点击 │ • 内存屏幕截图  │ • 网页搜索/打开 │ • 声明式 Skill  │
│ • 文本输入/按键 │ • MCP Image 回传│ • 页面提取/点击 │ • YAML 工作流   │
└─────────────────┴─────────────────┴─────────────────┴─────────────────┘

Related MCP server: WinCommander

Kernfunktionen und Sprachbefehle

Funktionskategorie

Beispiel für Sprachbefehl

Zugrunde liegendes Tool

Agenten-Orchestrierung

"XiaoZhi, lass Codex für mich die Wi-Fi-Wiederverbindungslogik zum ESP32-Projekt hinzufügen"

dispatch_agent(agent_type="codex", task="...", mode="modify")

Agenten-Fortschritt

"XiaoZhi, ist die Codex-Aufgabe von vorhin fertig?"

get_agent_status() (gibt eine kompakte Sprachzusammenfassung und Änderungsstatistiken zurück)

Agenten-Liste

"XiaoZhi, welche Agenten auf meinem Computer können arbeiten?"

list_active_agents() (erkennt Codex, Claude, OpenCode usw.)

Software-Start

"XiaoZhi, öffne VS Code" / "öffne Feishu"

open_application (intelligenter Scan des Startmenüs und des PATH)

Bildschirm-Vision

"XiaoZhi, schau, was auf meinem Computerbildschirm ist"

screen_capture (In-Memory-Screenshot für multimodale Analyse)

Dateisuche

"XiaoZhi, schau, welche PDFs auf dem Desktop sind"

find_files(path="Desktop", pattern="*.pdf")

Datei lesen/schreiben

"XiaoZhi, hilf mir, diese Konfiguration zu lesen / ein Snake-Spiel zu schreiben"

read_text_file / write_text_file

Projekt-Git

"XiaoZhi, schau, was in meinem Projekt kürzlich geändert wurde"

git_status / git_diff / git_log

Terminal-Ausführung

"XiaoZhi, führe die Tests dieses Projekts aus / überprüfe die Python-Version"

run_project_tests / run_shell_command

Browser-Interaktion

"XiaoZhi, suche das ESP32-S3-Datenblatt"

browser_search / browser_open

Schnellkonfiguration und Start

1. Umgebungsvorbereitung

  • Windows 10 / 11

  • Python 3.11+

  • (Optional) Installierte Codex CLI (npm i -g @openai/codex), Claude Code usw.

Abhängigkeiten installieren:

pip install -r requirements.txt

2. MCP-Endpoint konfigurieren

Kopieren Sie .env.example in .env und füllen Sie den Endpoint aus, den Sie von der XiaoZhi-Konsole erhalten haben:

XIAOZHI_MCP_ENDPOINT=wss://api.xiaozhi.me/mcp/?token=YOUR_TOKEN_HERE

3. Workspace konfigurieren (optional)

Fügen Sie in config.yaml Ihre lokalen Entwicklungsprojektpfade hinzu:

workspaces:
  agent:
    path: .
  esp32:
    path: D:/Projects/esp32
  stm32:
    path: D:/Projects/stm32

4. Agent ausführen

python main.py

Das Terminal gibt Folgendes aus:

===================================
 XiaoZhi Windows Agent
===================================
XiaoZhi MCP     CONNECTING
Tools           49
Security        ENABLED
Permission      UNRESTRICTED
MCP server handshake completed
Connected; registered 49 local tools

Automatisierte Tests

Führen Sie die vollständige Testsuite aus:

python -m pytest

This server cannot be installed

F
license - not found
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Kody

    Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.

  • Remote Desktop Commander

    Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • Frenchie

    OCR, transcription, file extraction, and image generation for AI agents via MCP.

View all MCP Connectors

Latest Blog Posts

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/Joho6666/xiaozhi-windows-agent'

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