About
Homeassistant MCP server for 小智AI
README
ha-mcp-for-xiaozhi
Homeassistant MCP server for 小智AI，直连小智AI官方服务器。
Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.
插件能力介绍
1.HomeAssistant自身作为mcp server 以websocket协议直接对接虾哥服务器，无需中转
2.在一个实体里同时选择多个API组（HomeAssistant自带控制API、用户自己配置的MCPServer）并将它们一起代理给小智
3.支持同时配置多个实体
功能演示（为爱发电不易，有币投投币、没币点点赞、刷几个弹幕也行）
安装方法：
确保Home Assistant中已安装HACS
1.打开HACS, 搜索 xiaozhi 或 ha-mcp-for-xiaozhi
2.下载插件
3.重启Home Assistant.
配置方法：
[设置 > 设备与服务 > 添加集成] > 搜索“Mcp” >找到MCP Server for Xiaozhi
下一步 > 请填写小智MCP接入点地址、选择需要的MCP > 提交。
注意llm_hass_api 复选框里 Assist 就是ha自带的function，其他选项是你在HomeAssistant里接入的其他mcp server（可以在这里直接代理给小智）
配置完成！！！稍等一分钟后到小智的接入点页面点击刷新，检查状态。
调试说明
1.暴露的工具取决于你公开给Homeassistant语音助手的实体的种类
设置 -> 语音助手 -> 公开
2.尽量使用最新版本的homeassistant，单单看5月版本跟3月版本提供的工具就有明显差异
3.调试时未达到预期，优先看小智的聊天记录，看看小智对这句指令如何处理的，是否有调用homeassistant的工具。目前已知比较大的问题是灯光控制和音乐控制会和内置的屏幕控制、音乐控制逻辑冲突，需要等下个月虾哥服务器支持内置工具选择后可解。
4.如果流程正确的调用了ha内置的function，可以打开本插件的调试日志再去观测实际的执行情况。
Installing Ha Mcp For Xiaozhi
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/c1pher-cn/ha-mcp-for-xiaozhiFAQ
Is Ha Mcp For Xiaozhi MCP free?
Yes, Ha Mcp For Xiaozhi MCP is free — one-click install via Unyly at no cost.
Does Ha Mcp For Xiaozhi need an API key?
No, Ha Mcp For Xiaozhi runs without API keys or environment variables.
Is Ha Mcp For Xiaozhi hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Ha Mcp For Xiaozhi in Claude Desktop, Claude Code or Cursor?
Open Ha Mcp For Xiaozhi on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Fetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
by modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
by xuzexin-hzCompare Ha Mcp For Xiaozhi with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All ai MCPs