Skip to main content
Glama
deenesjakoruzh
Joho6666

XiaoZhi Windows MCP Agent Bridge

by Joho6666
OverviewSchemaSourceRelated ServersDiscussionsAdmin
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: agentic-remote-pc

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 deployed

Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers