mcpField
M
mcp_ha_xiaozhi

mcp_ha_xiaozhi

github.com/shawn996Frameworks & SDKs54Updated 75w ago
Repository

About mcp_ha_xiaozhi

mcp_ha_xiaozhi connects the official Xiaozhi server with Home Assistant’s MCP server using mcp_proxy. It is for users running both services, and is configured with their endpoints and a Home Assistant long-lived access token; it can run in Docker.

Key features

  1. 01Bridge Xiaozhi and Home Assistant MCP
  2. 02Configure both MCP endpoints
  3. 03Authorize with a long-lived token
  4. 04Run with Docker

Use cases

  1. 01Connect the official Xiaozhi server to Home Assistant
  2. 02Set access authorization for Home Assistant MCP

MCP support

It links the official Xiaozhi server and the Home Assistant MCP server, bridging their MCP capabilities.

Details

From the project README

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 实例。
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/

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.