Skip to main content
Glama
deenesjakoruzh
Joho6666

XiaoZhi Windows MCP Agent Bridge

by Joho6666
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

XiaoZhi Windows MCP Agent Bridge

XiaoZhi Windows MCP Agent Bridge es un servicio puente que conecta los dispositivos de IA XiaoZhi ESP32 con micrófono y altavoz de su escritorio a su ordenador local con Windows.

A través del Model Context Protocol (MCP) estándar, XiaoZhi puede actuar como Comandante de Voz (Voice Commander), invocando herramientas locales de Windows, ejecutando operaciones del equipo, leyendo y escribiendo archivos en todo el disco, controlando el navegador Edge, capturando la pantalla para análisis visual y, sobre todo, orquestando la matriz de Agentes de IA locales como Codex CLI / Claude Code / OpenCode para ejecutar tareas pesadas de desarrollo e ingeniería.

Arquitectura general: Comandante de Voz + Matriz de Agentes local

小智 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

Funciones principales y comandos de voz

Categoría de función

Ejemplo de comando de voz

Herramienta subyacente

Orquestación de Agentes

"XiaoZhi, pídele a Codex que añada la lógica de reconexión Wi-Fi al proyecto ESP32"

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

Progreso del Agente

"XiaoZhi, ¿ha terminado ya la tarea de Codex?"

get_agent_status() (devuelve un resumen de voz conciso y estadísticas de cambios)

Inventario de Agentes

"XiaoZhi, ¿qué agentes hay disponibles en mi ordenador?"

list_active_agents() (detecta Codex, Claude, OpenCode, etc.)

Inicio de aplicaciones

"XiaoZhi, abre VS Code" / "Abre Feishu"

open_application (escanea inteligentemente el menú de inicio y el PATH)

Visión de pantalla

"XiaoZhi, mira qué hay en mi pantalla"

screen_capture (captura de pantalla en memoria para análisis multimodal)

Búsqueda de archivos

"XiaoZhi, mira qué PDFs hay en el escritorio"

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

Lectura y escritura de archivos

"XiaoZhi, léeme esta configuración / escribe un juego de la serpiente"

read_text_file / write_text_file

Git del proyecto

"XiaoZhi, mira qué he cambiado recientemente en mi proyecto"

git_status / git_diff / git_log

Ejecución en terminal

"XiaoZhi, ejecuta las pruebas de este proyecto / comprueba la versión de Python"

run_project_tests / run_shell_command

Interacción con el navegador

"XiaoZhi, busca la hoja de datos del ESP32-S3"

browser_search / browser_open

Configuración e inicio rápidos

1. Requisitos del entorno

  • Windows 10 / 11

  • Python 3.11+

  • (Opcional) Codex CLI instalado (npm i -g @openai/codex), Claude Code, etc.

Instalar dependencias:

pip install -r requirements.txt

2. Configurar el Endpoint MCP

Copie .env.example a .env y rellene el Endpoint obtenido de la consola de XiaoZhi:

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

3. Configurar el Workspace (opcional)

Añada la ruta de su proyecto de desarrollo local en config.yaml:

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

4. Ejecutar el Agente

python main.py

La terminal mostrará:

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

Pruebas automatizadas

Ejecutar el conjunto de pruebas completo:

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