xiaodu_mcp_ha

# Xiaodu MCP Home Assistant Custom Integration v2 Fixed Compatible with xiaodu-token-proxy v2/v2-fixed standard API: - `GET /api/devices` - `POST /api/speak` - `POST /api/command` - `POST /api/take_photo` And compatible with real device fields: - `client_id` - `cuid` - `device_name` - `online_status` / `online` - `location.house` / `location.floor` / `location.room` No longer transmit `userid`. ## Installation via HACS 1. Open HACS. 2. Go to the top right menu and select `Custom repositories`. 3. Repository: `https://github.com/linzhonghong/xiaodu_mcp_ha` 4. Category: `Integration` 5. Add and search for `Xiaodu MCP` and install. 6. Restart Home Assistant. 7. Go to `Settings → Devices & services → Add Integration → Xiaodu MCP` Enter the token-proxy root address, for example: ```text http://192.168.1.20:8088 ``` Do not include `/sse` or `/mcp/`. ## Manual Installation Copy `custom_components/xiaodu_mcp` to Home Assistant: ```text /config/custom_components/xiaodu_mcp ``` Restart Home Assistant, then: ```text Settings → Devices & services → Add Integration → Xiaodu MCP ``` Enter the token-proxy root address, for example: ```text http://192.168.1.20:8088 ``` Do not include `/sse` or `/mcp/`. ## Automation Examples ### Speak through Service ```yaml action: - action: xiaodu_mcp.speak target: device_id: your_xiaodu_device_id data: text: "Someone is pressing the doorbell, please check." ``` ### Speak through Text Entity ```yaml action: - action: text.set_value target: entity_id: text.xxx_bo_bao_wen_ben data: value: "Someone is pressing the doorbell, please check." ``` ### Take Photo ```yaml action: - action: button.press target: entity_id: button.xxx_pai_zhao ``` Or: ```yaml action: - action: xiaodu_mcp.take_photo target: device_id: your_xiaodu_device_id ``` ## Entities Each device will create: - State sensor - Test speak button - Take photo button - Recent photo camera - Speak text - Natural language command text