ha-mcp-for-xiaozhi
Homeassistant MCP server for 小智AI
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/c1pher-cn/ha-mcp-for-xiaozhi with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/c1pher-cn/ha-mcp-for-xiaozhi'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/c1pher-cn--ha-mcp-for-xiaozhi)HTML
<a href="/listings/c1pher-cn--ha-mcp-for-xiaozhi"><img src="/api/listings/c1pher-cn--ha-mcp-for-xiaozhi/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 111 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ## ha-mcp-for-xiaozhi
- 
- 
- 
- 
- 
- - [English](README.en.md)
- - [中文](README.md)
- <p align="center">
- <img src="https://raw.githubusercontent.com/c1pher-cn/brands/refs/heads/master/custom_integrations/ws_mcp_server/icon.png" alt="Alt Text" align="center">
- </p>
- <p align="center">
- Homeassistant MCP server for 小智AI,直连小智AI官方服务器。
- </p>
- [](https://my.home-assistant.io/redirect/hacs_repository/?owner=c1pher-cn&repository=ha-mcp-for-xiaozhi&category=integration)
- ### 插件能力介绍
- #### 1.HomeAssistant自身作为mcp server 以websocket协议直接对接虾哥服务器,无需中转
- #### 2.在一个实体里同时选择多个API组(HomeAssistant自带控制API、用户自己配置的MCPServer)并将它们一起代理给小智
- #### 3.支持同时配置多个实体
- ---
- ### 功能演示(为爱发电不易,有币投投币、没币点点赞、刷几个弹幕也行)
- <a href="https://www.bilibili.com/video/BV1XdjJzeEwe" > 接入演示视频 </a>
- <a href="https://www.bilibili.com/video/BV18DM8zuEYV" > 控制电视演示(通过自定义script实现)</a>
- <a href="https://www.bilibili.com/video/BV1SruXzqEW5" > HomeAssistant、LLM、MCP、小智的进阶教程 </a>
- ---
- ### 安装方法:
- 确保Home Assistant中已安装HACS
- 1.打开HACS, 搜索 xiaozhi 或 ha-mcp-for-xiaozhi
- <img width="2316" height="238" alt="image" src="https://github.com/user-attachments/assets/fa49ee7c-b503-49fa-ad63-512499fa3885" />
- 2.下载插件
- <img width="748" height="580" alt="image" src="https://github.com/user-attachments/assets/1ee75d6f-e1b0-4073-a2c7-ee0d72d002ca" />
- 3.重启Home Assistant.
- ### 配置方法:
- [设置 > 设备与服务 > 添加集成] > 搜索“Mcp” >找到MCP Server for Xiaozhi
- <img width="888" height="478" alt="image" src="https://github.com/user-attachments/assets/07a70fe1-8c6e-4679-84df-1ea05114b271" />
- 下一步 > 请填写小智MCP接入点地址、选择需要的MCP > 提交。
- 注意llm_hass_api 复选框里 Assist 就是ha自带的function,其他选项是你在HomeAssistant里接入的其他mcp server(可以在这里直接代理给小智)
- <img width="774" height="632" alt="image" src="https://github.com/user-attachments/assets/38e98fde-8a6c-4434-932c-840c25dc6e28" />
- 配置完成!!!稍等一分钟后到小智的接入点页面点击刷新,检查状态。
- 
- ---
- ### 调试说明
- 1.暴露的工具取决于你公开给Homeassistant语音助手的实体的种类
- 设置 -> 语音助手 -> 公开
- 2.尽量使用最新版本的homeassistant,单单看5月版本跟3月版本提供的工具就有明显差异
- 3.调试时未达到预期,优先看小智的聊天记录,看看小智对这句指令如何处理的,是否有调用homeassistant的工具。目前已知比较大的问题是灯光控制和音乐控制会和内置的屏幕控制、音乐控制逻辑冲突,需要等下个月虾哥服务器支持内置工具选择后可解。
- 4.如果流程正确的调用了ha内置的function,可以打开本插件的调试日志再去观测实际的执行情况。
- ---
- <a href="https://buymeacoffee.com/c1pher_cn" target="_blank" rel="noreferrer noopener">
- <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee">
- </a>
- <a href="https://star-history.com/#c1pher-cn/ha-mcp-for-xiaozhi&Date"></a>
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=c1pher-cn/ha-mcp-for-xiaozhi&type=Date&theme=dark" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=c1pher-cn/ha-mcp-for-xiaozhi&type=Date" />
- <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=c1pher-cn/ha-mcp-for-xiaozhi&type=Date" />
- </picture>
- </a>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.