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 — это мостовой сервис, который подключает устройства ESP32 XiaoZhi AI с микрофоном и динамиком к локальному компьютеру с Windows.

Благодаря стандартному Model Context Protocol (MCP) XiaoZhi может выступать в роли голосового командира (Voice Commander): вызывать локальные инструменты Windows, выполнять операции на компьютере, читать и записывать файлы на диске, управлять браузером Edge, делать снимки экрана для визуального анализа и, что особенно важно, координировать матрицу локальных AI-агентов, таких как Codex CLI / Claude Code / OpenCode, для выполнения сложных задач разработки и инженерии.

Общая архитектура: голосовой командир + матрица локальных агентов

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

Основные функции и голосовые команды

Категория функций

Пример голосовой команды

Базовый вызываемый инструмент

Планирование агентов

«Сяо Чжи, попроси Codex добавить логику переподключения Wi-Fi в проект ESP32»

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

Прогресс агентов

«Сяо Чжи, задача Codex уже выполнена?»

get_agent_status() (возвращает краткую голосовую сводку и статистику изменений)

Список агентов

«Сяо Чжи, какие агенты есть на моём компьютере?»

list_active_agents() (обнаруживает Codex, Claude, OpenCode и др.)

Запуск приложений

«Сяо Чжи, открой VS Code» / «открой Feishu»

open_application (интеллектуальное сканирование меню «Пуск» и PATH)

Визуальный анализ экрана

«Сяо Чжи, посмотри, что на экране моего компьютера»

screen_capture (снимок экрана в памяти для мультимодального анализа)

Поиск файлов

«Сяо Чжи, посмотри, какие PDF-файлы есть на рабочем столе»

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

Чтение и запись файлов

«Сяо Чжи, прочитай эту конфигурацию / напиши "Змейку"»

read_text_file / write_text_file

Git проекта

«Сяо Чжи, посмотри, что недавно изменилось в моём проекте»

git_status / git_diff / git_log

Выполнение в терминале

«Сяо Чжи, запусти тесты проекта / проверь версию Python»

run_project_tests / run_shell_command

Взаимодействие с браузером

«Сяо Чжи, найди техническое описание ESP32-S3»

browser_search / browser_open

Быстрая настройка и запуск

1. Подготовка окружения

  • Windows 10 / 11

  • Python 3.11+

  • (Необязательно) установленные Codex CLI (npm i -g @openai/codex), Claude Code и т.д.

Установка зависимостей:

pip install -r requirements.txt

2. Настройка MCP Endpoint

Скопируйте .env.example в .env и укажите Endpoint, полученный из консоли XiaoZhi:

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

3. Настройка Workspace (необязательно)

Добавьте путь к вашему локальному проекту разработки в config.yaml:

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

4. Запуск агента

python main.py

В терминале появится:

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

Автоматизированное тестирование

Запуск полного набора тестов:

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