mcpField
H
ha-xiaozhi-mcp

ha-xiaozhi-mcp

github.com/c1pher-cn框架与 SDK1075 周前更新

关于 ha-xiaozhi-mcp

ha-xiaozhi-mcp 是连接 Home Assistant 与小智 MCP 端点的临时中转方案,可让小智通过三个可用工具控制配置在 Home Assistant 中的智能家居设备。

主要功能

  1. 01中转 Home Assistant 与小智 MCP
  2. 02配置 Home Assistant API 凭据和地址
  3. 03提供三个可用工具
  4. 04在小智提示词中加入设备信息

适用场景

  1. 01通过小智控制 Home Assistant 设备
  2. 02将本地 Home Assistant 连接到小智 MCP 端点

MCP 相关

它在 Home Assistant 与小智提供的 MCP 端点之间运行 MCP 服务中转,并在 MCP 配置中显示三个可用工具。

详细介绍

来自项目 README

ha-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配置里是否正常显示三个可用工具

image

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%}

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。