3步跑通ESP32语音机器人基于MCP协议的小智固件入门【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32xiaozhi-esp32 是一个开源 ESP32 固件把开发板变成基于 MCP 协议智能语音机器人。它把大语言模型接进麦克风、喇叭和各类外设让你能用对话控制真实硬件。读完这篇教程你会完成一次完整的编译烧录看懂开发板怎么选并理解 MCP 协议在设备里怎么落地。三步编译并烧录固件️ 装 ESP-IDF v6.0.2 工具链。主线只保留 v5.5.2 给老旧板型新手直接用 v6。 克隆仓库git clone https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32 选板子并编译。脚本会在仓库里选 138 个板型目录之一python scripts/build.py⚡ 烧录并打开串口日志idf.py -p /dev/ttyUSB0 flash monitor固件默认连接官方 xiaozhi.me 服务器个人用户注册后可免费使用千问实时模型。配好 Wi-Fi 再说话听到第一句语音回复就说明链路通了。开发板怎么选入门档ESP32-S3 或 ESP32-C3 开发板加一块面包板。成本最低适合学习接线和验证功能。参考 docs/v1/wiring2.jpg 接线麦克风、喇叭、按键各占几根线。进阶档M5Stack CoreS3、ESP32-S3-BOX-3 这类集成开发板。屏幕、音频芯片都板载改一改配置就能用省掉外设调试时间。整机档esp-sparkbot、Electron Bot 这类机器人平台。带电机、表情屏和 WebSocket 控制服务适合做移动交互演示。所有板级初始化代码都在main/boards/下每个目录对应一种硬件先确认自己的板子有没有现成配置。背后原理MCP协议硬件控制与语音流水线设备端是一个 MCP 服务器后台 API 是客户端。两者跑在 WebSocket 或 MQTTUDP 传输上消息体遵循 JSON-RPC 2.0。连接建立后设备在 hello 消息里声明支持 MCP后台随即发现设备上注册的工具比如喇叭、LED、舵机、GPIO。模型生成一次工具调用设备执行真实硬件动作并回传结果详见 docs/mcp-protocol_zh.md。语音走一条统一流水线麦克风 PCM 进入音频引擎离线唤醒检测、回声消除、VAD 都在同一引擎内完成随后 Opus 编码上送网络。下行语音以 Opus 流式解码播放支持实时全双工对话。项目内置 38 种界面语言本地化语音提示放在main/assets/locales/目录。进阶玩法 自定义唤醒词基于 ESP-SR 的离线唤醒支持多网模型。录一段新唤醒词样本训练后替换默认唤醒词即可。 新增开发板在main/boards/下建目录实现板级初始化并写 config.h 和 config.json步骤参照 docs/custom-board_zh.md。板型名称要唯一避免 OTA 升级通道冲突。 接入第三方 AIWebSocket 与 MQTTUDP 两种传输各有协议文档分别见docs/websocket.md和docs/mqtt-udp.md自建或选择兼容后台即可替换大模型。踩坑清单编译现象是脚本报缺组件或版本不匹配。处理是确认 ESP-IDF 为 v6.0.x清理 build 目录后重编。烧录现象是找不到串口设备。处理是确认 USB 转串口驱动和串口号Windows 下重点核对 COM 口号。语音现象是误触或漏识别。处理是先查麦克风 I2S 接线再调整唤醒灵敏度。项目未内置降噪模型环境嘈杂会明显影响效果。接线现象是喇叭无声或爆音。处理是核对音频编解码芯片 I2C 地址与功放使能引脚先降低音量再逐步调。跑通第一块板子后建议动手改一次main/boards/下的配置理解每个引脚宏的作用。编译、接线或协议上的问题可以在仓库提 Issue或到官方社区群讨论。【免费下载链接】xiaozhi-esp32An MCP-based chatbot | 一个基于MCP的聊天机器人项目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考