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 小智 AI 기기를 로컬 Windows 컴퓨터에 연결하는 브리지 서비스입니다.

표준 **Model Context Protocol (MCP)**을 통해 小智는 음성 사령관(Voice Commander) 역할을 하여 Windows 로컬 도구 호출, 컴퓨터 작업 실행, 전체 디스크 파일 읽기/쓰기, Edge 브라우저 제어, 화면 캡처를 통한 시각 분석, 그리고 특히 로컬 Codex CLI / Claude Code / OpenCode 등 AI Agent 매트릭스를 스케줄링하여 대규모 개발 및 엔지니어링 작업을 실행할 수 있습니다.

전체 아키텍처: 음성 사령관 + 로컬 Agent 매트릭스

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

핵심 기능 및 음성 명령

기능 카테고리

음성 명령 예시

하위 호출 도구

Agent 스케줄링

"小智, Codex가 ESP32 프로젝트에 Wi-Fi 재연결 로직을 추가하게 해줘"

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

Agent 진행 상황

"小智, 방금 Codex 작업 완료됐어?"

get_agent_status() (간결한 음성 요약 및 변경 통계 반환)

Agent 목록

"小智, 내 컴퓨터에 작업할 수 있는 Agent가 뭐가 있어?"

list_active_agents() (Codex, Claude, OpenCode 등 감지)

소프트웨어 실행

"小智, VS Code 열어줘" / "飞书 열어줘"

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_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. Agent 실행

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