【AiPi-PalChatV1语音开发板】小智 MCP 接入 Home Assistant
本文介绍了 小安AI - AiPi-PalChatV1 语音开发板实现 MCP 接入 Home Assistant 的项目设计。
MCP 介绍
消息上下文协议 (Model Context Protocol, MCP) 是一个开放协议，用于标准化应用程序如何向 LLM 提供上下文。
MCP 为 AI 模型连接不同的数据源和工具提供了标准化的方式。
MCP 可用于构建 AI 驱动的 IDE、增强聊天界面、创建自定义 AI 工作流等场景。它能帮助开发者更好地管理和利用 LLM 的上下文信息。
详见：MCP中文简介 – MCP 中文站（Model Context Protocol 中文） . Model Context Protocol . MCP - python-sdk .
准备工作
包括 Home Assistant 安装以及 HACS 部署、小智 MCP 接入等流程。
Home Assistant 安装
1.安装 Docker 容器；
2.本地下载并部署 EMQX 平台；
3.部署 HomeAssistant 智能家居平台；
详见：【BW21-CBV-Kit 开发套件测评】OLED蓝牙温湿度计与Home Assistant连接 . 蓝牙温湿度计 DIY .
HACS 部署
在 Docker 安装 HomeAssistant 的基础上，部署 HACS 应用商店；
shell_command服务
复制代码到 HA 配置文件 configuration.yaml
shell_command:
update_hacs_china: |-
wget -O - https://get.hacs.vip | bash -
重启 HA 使配置生效；
在开发者工具中执行动作 action: shell_command.update_hacs_china ；
再次重启HA使更新后的 HACS 生效；
或下载 HACS 至本地，将其复制到 HA 安装目录 config/custom_components/hacs 路径，重启 HA ，添加集成即可。
参考：hacs-china . hacs-china 极速版 .
小智 MCP 接入 HA
介绍了小智 AI MCP 接入 Home Assistant 平台的主要流程。
原理
使用小智官方给的示例代码，结合 mcp_proxy，实现小智官方服务器和 Home Assistant 的 MCP Server 打通。
参数
-
XIAOZHI_MCP_ENDPOINT
- 小智 MCP 接入点，登录 小智 官方服务器获取；
-
HA_MCP_ENDPOINT
-
API_ACCESS_TOKEN
详见：shawn996/mcp_ha_xiaozhi: 小智官方服务器(虾哥)对接home assistant的mcp server .
安装
在 Home Assistant 已安装 HACS 的基础上
- 打开HACS, 点击
Custom repositories ；
Repository 输入项目地址: https://github.com/c1pher-cn/ha-mcp-for-xiaozhi ；Category 选择 Integration ；
- 点击 ADD 添加外部链接，选择
MCP Server for Xiaozhi 并 Download 下载安装该插件；
- 设置 - 右上角
更多 选项 - 重启 Home Assistant ；
- 进入HACS，可见 MCP Server for Xiaozhi 已下载和安装；
配置
- 设置 - 设备与服务 - 添加集成 - 搜索 MCP 安装
MCP Server for Xiaozhi ；
- 访问小智 AI 控制台，查看 MCP 接入点状态，显示
在线 表明 小智与 HA 连接配置成功。
- 在
设置 - 语音助手 选项下开启 HA 语音助手；
之后可通过 AiPi-PalChatV1 开发板控制 HomeAssistant 平台的设备、访问获取传感器参数等。
详见：Homeassistant MCP server for 小智AI .
Other
补充介绍了小智 MCP 启动器和小智 AI 客户端，便于设备调试与小智连接 HA 项目的测试。
小智 AI MCP 启动器
参考：小智AI配置MCP接入点使用说明 . 可视化xiaozhi接入mcp .
小智 AI 客户端
Python版本的小智ai，可以在没有硬件支持的条件下实现小智 AI 对话功能。
介绍
py-xiaozhi 是一个使用 Python 实现的小智语音客户端，旨在通过代码学习和在没有硬件条件下体验 AI 小智的语音功能。
IoT 功能
py-xiaozhi 提供丰富的 IoT 设备控制功能：
- 虚拟设备：灯光控制、音量调节、倒计时器等；
- 物理设备集成：温度传感器、摄像头等；
- Home Assistant集成：通过HTTP API接入智能家居系统；
- 自定义设备扩展：提供完整的设备定义和注册框架 。
详见：python版本的小智ai 、小智Android端 .
总结
本文介绍了 小安AI - AiPi-PalChatV1 语音开发板实现 MCP 接入 Home Assistant 的项目设计，为相关产品的物联网和 AI 智能产品的快速开发提供了参考。
