1. Conduid
  2. Developer Tools
  3. Ha MCP For Xiaozhi
MCP server · Developer Tools

Ha MCP For Xiaozhi

Homeassistant MCP server for 小智AI

69Good

Scored 8 hours ago · breakdown

About Ha MCP For Xiaozhi

Ha MCP For Xiaozhi is an MCP server published by c1pher-cn in the Developer Tools category: homeassistant MCP server for 小智AI.

The repository has 275 stars and 59 forks, with the last commit yesterday. Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/c1pher-cn/ha-mcp-for-xiaozhi

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Ha MCP For Xiaozhi

Powered by Claude · Grounded in docs

I know everything about Ha MCP For Xiaozhi. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 8 hours ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • ✓Tests presentA test suite exists in the repository.
  • !Dependencies pinnedNo lockfile. Installs can pull different code over time.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v0.2.0更新mcp server底层逻辑 · 5 Sep 2026与9月版本一起同步修改mcpserver 底层逻辑
v0.1.2bugfix · 23 Aug 2026没有功能更新,仅更新mcp包依赖
v0.1.1修复10月版本依赖问题 · 6 Oct 2025
v0.1.0修复自动打包的路径问题 · 16 Aug 2025
v0.0.11The version for hacs · 14 Aug 2025进入hacs的第一个版本 The version for hacs 文档支持中英双语 the readme support both Chinese and English

README

ha-mcp-for-xiaozhi

GitHub Repo stars GitHub forks GitHub release (latest by date) GitHub release (latest by date) GitHub release (latest by date)

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.支持同时配置多个实体


功能演示(为爱发电不易,有币投投币、没币点点赞、刷几个弹幕也行)

接入演示视频

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

HomeAssistant、LLM、MCP、小智的进阶教程


安装方法:

确保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(可以在这里直接代理给小智)

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

bd06b555b9e5c24fbf819c43397c97ee


调试说明

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

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

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

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

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


README fetched from the repository 8 hours ago. The original is authoritative.

Questions

About Ha MCP For Xiaozhi

How do I install Ha MCP For Xiaozhi?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Ha MCP For Xiaozhi safe to use with an AI agent?

Its trust score is 69 out of 100 (good). It passes 4 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Ha MCP For Xiaozhi still maintained?

Yes — the latest release is v0.2.0 (5 Sep 2026), and the last commit was yesterday. The repository has 275 stars and 1 open issues.