Home Assistant MCP
2025.03.16
15
Python智能家居控制设备自动化位置服务
Home Assistant MCP 是一个基于 Model Context Protocol (MCP) 的集成工具，旨在通过 AI 助手控制 Home Assistant 设备。它提供了搜索设备、控制设备开关、调整灯光颜色和亮度等功能，适用于智能家居自动化场景。
View on GitHub
Overview
基本能力
产品定位
Home Assistant MCP 是一个智能家居控制工具，通过 AI 助手实现对 Home Assistant 设备的自动化控制。
核心功能
- 设备搜索：支持通过自然语言搜索 Home Assistant 实例中的设备。
- 设备控制：支持开关设备（如灯光、电器等）。
- 灯光控制：支持调整灯光的颜色（RGB）和亮度。
适用场景
- 智能家居自动化控制
- 通过语音或文本命令控制家庭设备
- 灯光场景设置（如调整颜色和亮度）
工具列表
- 搜索工具：用于查找 Home Assistant 中的设备实体。
- 控制工具：用于开关设备或调整设备状态。
- 灯光控制工具：用于设置灯光颜色和亮度。
常见问题解答
- 认证问题：检查令牌是否正确且未过期。
- 连接问题：确保 Home Assistant 实例可访问且 URL 配置正确。
- 灯光控制问题：确认设备支持 RGB 控制且已开启。
使用教程
使用依赖
- Python 3.11 或更高版本
- 运行中的 Home Assistant 实例（可通过 API 访问）
- Home Assistant 长期访问令牌
安装教程
- 克隆仓库：
bash git clone <repository_url> - 设置 Python 环境：
bash cd home-assistant python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -U pip pip install uv uv pip install -e .
配置
- 获取 Home Assistant 长期访问令牌。
- 在 Cursor AI 中配置 MCP：
json { "mcpServers": { "home_assistant": { "command": "uv", "args": [ "--directory", "/path/to/your/home-assistant-mcp", "run", "main.py" ], "env": { "HOME_ASSISTANT_TOKEN": "your_token_here" }, "inheritEnv": true } } } - 修改
HA_URL（如需要）。
调试方式
- 使用自然语言命令测试设备控制（如“打开厨房灯”）。
- 检查日志或错误信息以排查问题。