MCP ExplorerExplorer

Ha Mcp For Xiaozhi

@c1pher-cnon 9 months ago
45 MIT
FreeCommunity
AI Systems
Homeassistant MCP server for 小智AI

Overview

What is Ha Mcp For Xiaozhi

ha-mcp-for-xiaozhi is a Homeassistant MCP server designed for 小智AI, enabling direct communication with the official 小智AI server via WebSocket without the need for additional proxies or tokens.

Use cases

Use cases include automating smart home devices, integrating AI responses into home automation routines, and enhancing user interaction with smart systems through 小智AI.

How to use

To use ha-mcp-for-xiaozhi, first install HACS in Home Assistant, then add the repository link ‘https://github.com/c1pher-cn/ha-mcp-for-xiaozhi’ in Custom repositories. After downloading the integration, restart Home Assistant and configure it by adding the MCP access point address for 小智.

Key features

Key features include direct WebSocket communication, elimination of proxy overhead, and simple configuration without the need for tokens.

Where to use

ha-mcp-for-xiaozhi can be used in smart home automation systems, particularly those utilizing Home Assistant and 小智AI for enhanced AI functionalities.

Content

ha-mcp-for-xiaozhi

Homeassistant MCP server for 小智AI,homeassistant 内置mcpserver通过websocket直连小智AI官方服务器。

v0.0.6 新增功能:支持同时配置多个实体,并可以将HomeAssistant已连接的其他MCPserver,一起代理给小智MCP

原理:实现了mcp over websocket,省去了虾哥mcp代理部分的额外开销,不需要填任何token,只需要一个虾哥提供的mcp接入点地址.


接入演示视频

控制电视演示(通过自定义script实现)


安装方法:

确保Home Assistant中已安装HACS

1.打开HACS, 点击[Custom repositories], Repository 输入本项目地址: https://github.com/c1pher-cn/ha-mcp-for-xiaozhi

2.Category 选择 [Integration]

5e1048c4fbd23d3385c09985fd09b50e

3.下载插件
d20fa7d2367fecc35bd8914b1f508ea6

4.重启Home Assistant.

配置方法:

[设置 > 设备与服务 > 添加集成] > 搜索“Mcp” >找到MCP Server for Xiaozhi
8ca5334a2d15f59325f3d5acb12083c8

下一步 > 请填写小智MCP接入点地址 > 提交。
6f4b22e8bd8190d4f0faeaba731481f9

配置完成!!!稍等一分钟后到小智的接入点页面点击刷新,检查状态。
bd06b555b9e5c24fbf819c43397c97ee


调试说明

1.暴露的工具取决于你公开给Homeassistant语音助手的实体的种类

设置 -> 语音助手 -> 公开

2.尽量使用最新版本的homeassistant,单单看5月版本跟3月版本提供的工具就有明显差异

3.调试时未达到预期,优先看小智的聊天记录,看看小智对这句指令如何处理的,是否有调用homeassistant的工具。目前已知比较大的问题是灯光控制和音乐控制会和内置的屏幕控制、音乐控制逻辑冲突,需要等下个月虾哥服务器支持内置工具选择后可解。

4.如果流程正确的调用了ha内置的function,可以打开本插件的调试日志再去观测实际的执行情况。


Star History Chart

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers