ha_mcp_xiaozhi_bridge

The ha_mcp_xiaozhi_bridge is a bridge that connects XiaoZhi AI with Home Assistant using the MCP agent. It integrates the official server with the Home Assistant MCP server. Installation can be done via HACS or manually, and configuration is straightforward. By entering the required parameters, users can achieve seamless connectivity.

GitHub Stars

6

User Rating

Not Rated

Favorites

0

Views

32

Forks

2

Issues

2

README

小智AI通过MCP Agent方式接入HA

ha_mcp_xiaozhi_bridge

小智官方服务器(虾哥)对接home assistant的mcp server 桥接集成

原理

使用小智官方给的示例代码,结合mcp_proxy,实现小智官方服务器和home assistant的mcp server打通,并以插件形式接入HA

安装

请使用以下方式安装:

方法 1: HACS安装
  1. 确保Home Assistant中已安装HACS
  2. 打开HACS, 点击[Custom repositories], Repository 输入: https://github.com/linrol/ha_mcp_xiaozhi_bridge, Category 选择 [Integration]
  3. 搜索MCP XiaoZhi Bridge并下载
  4. 重启Home Assistant.
方法 2:手动安装
  1. Latest Release 下载 mcp_bridge.zip
  2. 解压并复制 mcp_bridge/custom_components/.
  3. 重启 Home Assistant.
配置

[设置 > 设备与服务 > 添加集成] > 搜索“MCP XiaoZhi Bridge” > 下一步 > 请输入需要的配置参数,参数说明和获取如下

XIAOZHI_MCP_ENDPOINT:你的小智 MCP 接入点
HA_MCP_ENDPOINT:你的 HA MCP SERVER 地址
API_ACCESS_TOKEN:你的长效 API 令牌

  1. 小智 MCP 接入点: 登录小智官方服务器即可获取。
  2. HA MCP SERVER 地址: 通过 HA 官方的 mcp_server 集成获取。
    • 点击此链接:Home Assistant MCP Server 集成直达安装
    • 或 在 Home Assistant 中,前往 设置 > 设备和服务 > 添加集成
    • 从列表中选择“模型上下文协议服务器”,并按照屏幕上的说明完成设置。
  3. 长效 API 令牌: 用于授权访问你的 Home Assistant 实例。
启动

配置完成后会出现一个switch的实体开关,控制集成的开启和关闭,
成功开启后,在小智 控制台 MCP接入点可看到接入点状态