Skip to main content
Glama
deenesjakoruzh
Joho6666

XiaoZhi Windows MCP Agent Bridge

by Joho6666
OverviewSchemaRelated ServersScoreDiscussions
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: WinCommander

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

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

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

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

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

«Сяо Чжи, попроси 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 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