ha-mcp-for-xiaozhi

## ha-mcp-for-xiaozhi      - [English](README.en.md) - [中文](README.md) <p align="center"> <img src="https://raw.githubusercontent.com/c1pher-cn/brands/refs/heads/master/custom_integrations/ws_mcp_server/icon.png" alt="Alt Text" align="center"> </p> <p align="center"> Homeassistant MCP server for 小智AI, directly connecting to the official 小智AI server. </p> [](https://my.home-assistant.io/redirect/hacs_repository/?owner=c1pher-cn&repository=ha-mcp-for-xiaozhi&category=integration) ### Plugin Capability Introduction #### 1. HomeAssistant itself acts as an MCP server, directly connecting to the 虾哥 server via the websocket protocol without intermediaries. #### 2. Select multiple API groups (HomeAssistant's built-in control APIs and user-configured MCPServer) within a single entity and proxy them to 小智 together. #### 3. Supports configuring multiple entities simultaneously. --- ### Function Demonstration (It's not easy to create for love; if you have coins, please donate; if not, a like or a few comments will do) <a href="https://www.bilibili.com/video/BV1XdjJzeEwe"> Access demonstration video </a> <a href="https://www.bilibili.com/video/BV18DM8zuEYV"> TV control demonstration (achieved through custom script) </a> <a href="https://www.bilibili.com/video/BV1SruXzqEW5"> Advanced tutorial for HomeAssistant, LLM, MCP, and 小智 </a> --- ### Installation Method: Ensure that HACS is installed in Home Assistant. 1. Open HACS, search for xiaozhi or ha-mcp-for-xiaozhi. <img width="2316" height="238" alt="image" src="https://github.com/user-attachments/assets/fa49ee7c-b503-49fa-ad63-512499fa3885" /> 2. Download the plugin. <img width="748" height="580" alt="image" src="https://github.com/user-attachments/assets/1ee75d6f-e1b0-4073-a2c7-ee0d72d002ca" /> 3. Restart Home Assistant. ### Configuration Method: [Settings > Devices & Services > Add Integration] > Search for “Mcp” > Find MCP Server for Xiaozhi. <img width="888" height="478" alt="image" src="https://github.com/user-attachments/assets/07a70fe1-8c6e-4679-84df-1ea05114b271" /> Next > Please fill in the 小智 MCP access point address, select the required MCP > Submit. Note that the llm_hass_api checkbox with Assist refers to the built-in function of HA, while other options are the other MCP servers you have integrated in HomeAssistant (which can be directly proxied to 小智 here). <img width="774" height="632" alt="image" src="https://github.com/user-attachments/assets/38e98fde-8a6c-4434-932c-840c25dc6e28" /> Configuration completed!!! Wait a minute, then go to the 小智 access point page and click refresh to check the status.  --- ### Debugging Instructions 1. The exposed tools depend on the types of entities you expose to the Homeassistant voice assistant. Settings -> Voice Assistant -> Expose 2. Try to use the latest version of Home Assistant; there are significant differences in the tools provided between the May and March versions. 3. If the debugging does not meet expectations, first check the chat records of 小智 to see how it processed the command and whether it called the Home Assistant tools. Currently, a known major issue is that light control and music control may conflict with the built-in screen control and music control logic, which will be resolved once the 虾哥 server supports built-in tool selection next month. 4. If the process correctly calls the built-in functions of HA, you can open the debug log of this plugin to observe the actual execution situation. --- <a href="https://buymeacoffee.com/c1pher_cn" target="_blank" rel="noreferrer noopener"> <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee"> </a> <a href="https://star-history.com/#c1pher-cn/ha-mcp-for-xiaozhi&Date"></a> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=c1pher-cn/ha-mcp-for-xiaozhi&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=c1pher-cn/ha-mcp-for-xiaozhi&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=c1pher-cn/ha-mcp-for-xiaozhi&type=Date" /> </picture> </a>