AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
MCP verified MIT Self-run

Xiaozhi Deploy Guide

mcp-linlop911-xiaozhi-deploy-guide · by linlop911

Bilingual guide for deploying XiaoZhi (xiaozhi-esp32) locally: server, firmware, LLM/TTS and MCP | 小智本地部署中英双语教程：服务器、固件、大模型语音与 MCP

↗ Repository
— No reviews yet
0 installs
16 views
0.0% view→install

Install

$ agentstack add mcp-linlop911-xiaozhi-deploy-guide

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ● Network access Used
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/mcp-linlop911-xiaozhi-deploy-guide)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
● 1mo ago

Declared compatibility

Claude CodeClaude DesktopCursorWindsurf

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Xiaozhi Deploy Guide? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

XiaoZhi Local Deployment Guide

[English](README.md) | [简体中文](README_zh.md)

A practical, step-by-step bilingual guide for deploying XiaoZhi (小智) — the open-source AI voice assistant — on your own hardware and server. It covers the whole local deployment workflow: server deployment, LLM / ASR / TTS configuration, firmware build & flash, MCP extension, digital human module, and troubleshooting.

What is XiaoZhi?

XiaoZhi is an open-source AI voice assistant ecosystem:

  • ESP32 device (firmware) — captures audio, detects the wake word offline, plays replies, and shows status on a display
  • xiaozhi-server — handles speech recognition (ASR), LLM conversation, text-to-speech (TTS), OTA, and MCP tool management
  • LLM API — Qwen, DeepSeek, or any OpenAI-compatible model
  • MCP endpoint (optional) — connects external tools (calculator, weather, smart home, ...) to your assistant
  • Digital human module (optional) — browser-based avatar page with local wake-word runtime for testing/display

System Architecture

ESP32 device (firmware)  ⇄ WebSocket ⇄ xiaozhi-server (ASR + LLM + TTS)  → LLM API
                                        ⇄ MCP ⇄ mcp-endpoint-server → custom tools
                                        ⇄ digital-human (browser test page)

Table of Contents

| # | Chapter | 章节 | | --- | --- | --- | | 1 | [Deployment Overview](docs/01-部署方式总览.md) | [部署方式总览](docs/01-部署方式总览.md) | | 2 | [Server Deployment](docs/02-服务器端部署.md) | [服务器端部署](docs/02-服务器端部署.md) | | 3 | [MCP Endpoint Deployment](docs/03-MCP接入点部署.md) | [MCP 接入点部署](docs/03-MCP接入点部署.md) | | 4 | [Adding MCP Features](docs/04-给小智接入MCP功能.md) | [给小智接入 MCP 功能](docs/04-给小智接入MCP功能.md) | | 5 | [Firmware Build & Flash](docs/05-固件编译烧录.md) | [固件编译与烧录](docs/05-固件编译烧录.md) | | 6 | [LLM & Voice Configuration](docs/06-大模型与语音配置.md) | [大模型与语音配置](docs/06-大模型与语音配置.md) | | 7 | [FAQ](docs/07-常见问题FAQ.md) | [常见问题 FAQ](docs/07-常见问题FAQ.md) | | 8 | [Digital Human Module](docs/08-数字人模块.md) | [数字人模块](docs/08-数字人模块.md) | | 9 | [Common Errors & Screenshots](docs/09-常见报错与截图.md) | [常见报错与截图](docs/09-常见报错与截图.md) |

Recommended Path

  1. Deploy the server (Chapter 2)
  2. Configure the LLM (Chapter 6)
  3. Build and flash the firmware (Chapter 5)
  4. Provision Wi-Fi and start talking
  5. Extend with MCP tools (Chapters 3 & 4) or the digital human module (Chapter 8)

Upstream Projects

License

MIT — see [LICENSE](LICENSE).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in AI & ML