AI语音-教程-小智ai通过mcp控制ha

silas3082

   手上有一个小智，接入了虾哥的服务器，之前一直想接入ha，苦于没有办法。

最近知道可以通过MCP接入ha,感谢QQ群大佬“空白”给予的指导





1.下载mcp.rar文件，传到服务器上，解压；


2.ssh登录到服务器，我是飞牛nas,cd到解压的目录，将mcp-app-config.py中的

HA_URL = "YOUR HA_URL"
HOME_ASSISTANT_TOKEN = "YOUR HOME_ASSISTANT_TOKEN"

复制代码

3.回到mcp目录，运行下边代码构建容器：

docker build -t mcp:v1.0 .

复制代码

完成之后如图所示

4.运行下边代码启动容器

docker run -dit --restart=always \
  -e MCP_ENDPOINT=你的小智接入点地址 \
  -p 9882:9882 \
  -v /vol1/1000/docker/mcp/:/app/ \
  --name mcp \
  mcp:v1.0

复制代码

其中把/vol1/1000/docker/mcp/改为你实际mcp的目录，把MCP_ENDPOINT改为你的小智接入点地址。

MCP_ENDPOINT在：https://xiaozhi.me/-智能体-配置角色-MCP接入点



容器启动之前是未连接状态



容器启动之后显示在线

这样就可以控制ha设备了。



另外一个大佬直接接入ha官方的MCP,功能更多，推荐，不用再按照这个教程来了：AI语音-应用-小智AI和Ha无缝对接：官方 MCP 接入点的最佳实践 - 『HomeAssistant』综合讨论区 - 『瀚思彼岸』» 智能家居技术论坛 - Powered by Discuz!

sunn

ERROR [internal] load metadata for docker.io/library/python:3.11  构建失败

laojimigu

前两天试了一下,效果不是很好..
ha的API没法筛选出公开给语音助手的实体,导致操作的时候总是选到错误的实体上

silas3082

laojimigu 发表于 2025-5-18 19:29
前两天试了一下,效果不是很好..
ha的API没法筛选出公开给语音助手的实体,导致操作的时候总是选到错误的实体 ...

确实能找到好多实体，估计需要进一步训练

cmxiaoxiao

刚刚用上了，感谢大佬！目前遇到的问题就是实体太多，名字要对应才能控制，偶尔失灵。期待优化更新

yjl

希望“空白”大佬可以改进一下项目，HA已经有官方的MCP插件，不需要在自己重新构建MCP协议了，直接让小智调用HA的官方MCP协议即可

wangmucha

加油啊 优化下直接用小智插件mcp 我看集成里已经有了 就是不知道怎么运行起来 我没有地方创建MCP服务器的地方 能用ha自己解决的千万不要再衍生出一个mcp服务器来啊

jasona3

sunn 发表于 2025-5-18 17:50
ERROR [internal] load metadata for docker.io/library/python:3.11  构建失败

手动拉取镜像：执行 docker pull python:3.11