关于 ha-xiaozhi-mcp
ha-xiaozhi-mcp 是连接 Home Assistant 与小智 MCP 端点的临时中转方案,可让小智通过三个可用工具控制配置在 Home Assistant 中的智能家居设备。
主要功能
- 01中转 Home Assistant 与小智 MCP
- 02配置 Home Assistant API 凭据和地址
- 03提供三个可用工具
- 04在小智提示词中加入设备信息
适用场景
- 01通过小智控制 Home Assistant 设备
- 02将本地 Home Assistant 连接到小智 MCP 端点
MCP 相关
它在 Home Assistant 与小智提供的 MCP 端点之间运行 MCP 服务中转,并在 MCP 配置中显示三个可用工具。
详细介绍
来自项目 READMEha-xiaozhi-mcp
homeassistant mcpserver的临时中转方案
下载全部文件到你的环境中
1.安装依赖
执行 pip install -r requirements.txt
2.配置conf
api_key ha的长效token
base_url ha的地址,在本地环境就填局域网地址
MCP_ENDPOINT 小智官方提供的mcp地址
3.启动mcpserver
执行 python mcp_pipe.py hass.py
4.检查状态
运行成功后检查mcp配置里是否正常显示三个可用工具
5.配置提示词
在小智的提示词里加入你的设备信息,之前在三方server有部署过的可以直接粘贴,没整理过得可以用我这个模板去批量获取一下 (尽量精简,不要贴太多无用的传感器) 我的例子:
×××你的其他提示词××× 你也可以帮我控制家里的智能设备,你所在的位置在书房,未指定区域的情况下优先控制书房的设备。你的以下是设备列表:
- 房间,设备名称,设备id(entity_id)
- 书房,吸顶灯,light.649e3159aa36_light
- 书房,音响,media_player.shu_fang_2
- 书房,显示器挂灯,light.yeelink_lamp22_fd36_light
- 书房,灯带,light.plug_158df955a6167a
批量获取设备的模板: {% set area_list=['书房','主卧'] %} {% for area in area_list %} {% set device_list = area_entities(area) | reject('is_hidden_entity') %} {% for device in device_list %} {% if 'light' in device or 'switch' in device %} {{area}},{{device}},{{state_attr(device, 'friendly_name')}} {% endif %} {% endfor%} {% endfor%}
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。