Home Assistant MCP 服务器

快速入门

前置条件

• Home Assistant 实例与长效访问令牌
• Docker（推荐）或 Python 3.13+ 和 uv

安装

1. 拉取 Docker 镜像： docker pull voska/hass-mcp:latest
2. 在 Claude Desktop 中配置：
   • 打开设置，编辑 claude_desktop_config.json 文件。
   • 添加以下内容并替换 YOUR_LONG_LIVED_TOKEN 和 HA_URL： { "mcpServers": { "hass-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "HA_URL", "-e", "HA_TOKEN", "voska/hass-mcp" ], "env": { "HA_URL": "http://homeassistant.local:8123", "HA_TOKEN": "YOUR_LONG_LIVED_TOKEN" } } } }
3. 保存文件并重启 Claude Desktop。

使用示例

• 查询设备状态："客厅灯的状态是什么？"
• 控制设备："关闭厨房的所有灯"
• 列出传感器："列出所有包含温度数据的传感器"

更多工具和详细信息，请参考 README。