mcp_ha_xiaozhi
- other
小智官方服务器(虾哥)对接home assistant的mcp server
About
What is mcp_ha_xiaozhi?
mcp_ha_xiaozhi is a Docker-based MCP server that bridges the 小智 (XiaoZhi) official server with Home Assistant’s MCP server, enabling integration between the two platforms. It is designed for users who want to control Home Assistant devices through the XiaoZhi ecosystem.
How to use mcp_ha_xiaozhi?
Run the provided Docker command, setting three environment variables: XIAOZHI_MCP_ENDPOINT (your XiaoZhi MCP endpoint), HA_MCP_ENDPOINT (your Home Assistant MCP server address), and API_ACCESS_TOKEN (a long-lived Home Assistant API token). Obtain the XiaoZhi endpoint by logging into the XiaoZhi official server, and the Home Assistant MCP server address by installing the official mcp_server integration in Home Assistant.
Key features of mcp_ha_xiaozhi
- Bridges XiaoZhi official server with Home Assistant MCP server
- Uses mcp_proxy for protocol translation
- Runs as a simple Docker container
- Configuration via three environment variables
- Leverages official Home Assistant MCP server integration
Use cases of mcp_ha_xiaozhi
- Control Home Assistant devices via XiaoZhi voice or automation
- Integrate XiaoZhi’s AI capabilities with Home Assistant home control
- Enable cross-platform MCP communication between XiaoZhi and HA
- Deploy a lightweight bridge in home automation setups
FAQ from mcp_ha_xiaozhi
What does mcp_ha_xiaozhi do?
It acts as a bridge that connects the XiaoZhi official server to Home Assistant’s MCP (Model Context Protocol) server, allowing the two systems to exchange information and commands.
How do I get the Home Assistant MCP server address?
Install the official Home Assistant MCP server integration by going to Settings > Devices & Services > Add Integration and choosing “Model Context Protocol Server,” or use this direct link.
Where can I get the long-lived API token?
Visit your Home Assistant profile settings, go to the Security tab, and create a Long-Lived Access Token.
How do I run mcp_ha_xiaozhi?
Use the Docker command provided in the README, passing the three required environment variables to the container shawn68/mcp_ha_xiaozhi.
Is mcp_ha_xiaozhi free to use?
The README does not mention any pricing or licensing; it is available as a public Docker image on Docker Hub.
Details
- Author
- shawn996
- GitHub stars
- 20
- Category
- other
- Repository
- shawn996/mcp_ha_xiaozhi
mcp_ha_xiaozhi
小智官方服务器(虾哥)对接home assistant的mcp server原理
使用小智官方给的示例代码，结合mcp_proxy,实现小智官方服务器和home assistant的mcp server打通参数
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 实例。
访问你的 Home Assistant 账户配置文件设置，进入“安全”选项卡。
* 创建长期访问令牌。
docker运行
docker run -d --name mcp_ha_xiaozhi \
-e XIAOZHI_MCP_ENDPOINT="你的小智MCP接入点" \
-e HA_MCP_ENDPOINT="你的HA MCP SERVER地址" \
-e API_ACCESS_TOKEN="你的长时效API令牌" \
shawn68/mcp_ha_xiaozhi
https://hub.docker.com/r/shawn68/mcp_ha_xiaozhi/
