mcp_ha_xiaozhi

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.