高可用mcp小智服务器

Name: 高可用mcp小智服务器
Author: c1pher-cn

作者：c1pher-cn166 星标更新：2025-10-10

安装使用来源：spider==github.com

项目介绍

ha-mcp-for-xiaozhi

<p align="center"> <img src="https://gips2.baidu.com/it/u=426287921,1262194427&fm=3081&app=3081&f=PNG?w=256&h=256" alt="Alt Text" align="center"> </p> <p align="center"> 面向Homeassistant的小智AI MCP服务器，直接连接到小智AI官方服务器。 </p>

插件功能简介

1. HomeAssistant自身作为MCP服务器，通过WebSocket协议直接连接到小智服务器，无需中间环节

2. 在一个实体中选择多个API组（HomeAssistant内置控制API，用户配置的MCPServer），并将其代理到小智

3. 支持同时配置多个实体

功能演示（爱不易谋生，如果有硬币，请捐赠；如果没有，点赞或留言也行）

<a href="https://www.bilibili.com/video/BV1XdjJzeEwe" > 访问演示视频 </a>

<a href="https://www.bilibili.com/video/BV18DM8zuEYV" > 电视控制演示（通过自定义脚本实现）</a>

<a href="https://www.bilibili.com/video/BV1SruXzqEW5" > HomeAssistant、LLM、MCP和小智的高级教程 </a>

安装方法：

确保Home Assistant中已安装HACS

1. 打开HACS，搜索xiaozhi或ha-mcp-for-xiaozhi

2. 下载插件

3. 重启Home Assistant

配置方法：

[设置 > 设备与服务 > 添加集成] > 搜索"Mcp" > 查找小智MCP服务器

下一步 > 请输入小智MCP接入点地址，选择所需的MCP > 提交。

注意，llm_hass_api中的“辅助”复选框指的是HomeAssistant的内置功能，而其他选项是您连接到HomeAssistant的额外MCP服务器（可以直接在这里代理到小智）

配置完成！！！等待一分钟，然后前往小智的接入点页面点击刷新查看状态。

bd06b555b9e5c24fbf819c43397c97ee

调试指南

暴露的工具取决于您向Homeassistant语音助手公开的实体类型

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

2. 尽量使用最新版本的Home Assistant，因为5月版和3月版提供的工具差异明显

3. 在调试过程中，如果未能达到预期结果，首先检查小智的聊天记录，看看小智如何处理此命令以及是否调用了HomeAssistant工具。目前主要已知的问题是灯光控制和音乐控制与内置屏幕控制和音乐控制逻辑之间的冲突。这些问题将在下个月的小智服务器支持内置工具选择后得到解决。

4. 如果过程正确调用了内置的ha函数，您可以启用此插件的调试日志以观察实际执行情况。