Content
## 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 Capabilities
#### 1. Home Assistant itself acts as an MCP server, directly connecting to the 虾哥 server via the websocket protocol without intermediaries.
#### 2. Select multiple API groups (Home Assistant'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 power this with love, feel free to donate if you can, or just give a like or send a few comments)
<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 Home Assistant, 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 小智.
<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 checkbox for llm_hass_api, Assist refers to the built-in function of Home Assistant, while other options are the other MCP servers you have integrated in Home Assistant (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 complete!!! 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 Home Assistant 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 expected results are not achieved during debugging, first check the chat history 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 Home Assistant, 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>
