ha-mcp-for-xiaozhi
If you are the rightful owner of ha-mcp-for-xiaozhi and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Homeassistant MCP server for 小智AI enables direct connection to the official 小智AI server using the websocket protocol, eliminating the need for intermediaries.
ha-mcp-for-xiaozhi
Homeassistant MCP server for 小智AI,直连小智AI官方服务器。
插件能力介绍
1.HomeAssistant自身作为mcp server 以websocket协议直接对接虾哥服务器,无需中转
2.在一个实体里同时选择多个API组(HomeAssistant自带控制API、用户自己配置的MCPServer)并将它们一起代理给小智
3.支持同时配置多个实体
!!!注意,v0.0.8 版本需要使用2025.7.0及以后版的HomeAssistant, 2025.3-2025.6版本的homeassistant 请使用 v0.0.7 谢谢配合!!!
功能演示(为爱发电不易,有币投投币、没币点点赞、刷几个弹幕也行)
安装方法:
确保Home Assistant中已安装HACS
1.打开HACS, 点击[Custom repositories], Repository 输入本项目地址: https://github.com/c1pher-cn/ha-mcp-for-xiaozhi
2.Category 选择 [Integration]
3.下载插件
4.重启Home Assistant.
配置方法:
[设置 > 设备与服务 > 添加集成] > 搜索“Mcp” >找到MCP Server for Xiaozhi
下一步 > 请填写小智MCP接入点地址 > 提交。
配置完成!!!稍等一分钟后到小智的接入点页面点击刷新,检查状态。
调试说明
1.暴露的工具取决于你公开给Homeassistant语音助手的实体的种类
设置 -> 语音助手 -> 公开
2.尽量使用最新版本的homeassistant,单单看5月版本跟3月版本提供的工具就有明显差异
3.调试时未达到预期,优先看小智的聊天记录,看看小智对这句指令如何处理的,是否有调用homeassistant的工具。目前已知比较大的问题是灯光控制和音乐控制会和内置的屏幕控制、音乐控制逻辑冲突,需要等下个月虾哥服务器支持内置工具选择后可解。
4.如果流程正确的调用了ha内置的function,可以打开本插件的调试日志再去观测实际的执行情况。