Home Assistant MCP

基本能力

产品定位

Home Assistant MCP 是一个连接 AI 助手与 Home Assistant 智能家居系统的桥梁，使 AI 能够直接控制和查询智能家居设备。

核心功能

1. Home Assistant API 验证：检查 Home Assistant API 是否在线。
2. 获取实体状态：查询指定智能家居设备的当前状态。
3. 调用服务：对指定设备执行特定操作（如开灯、关灯等）。

适用场景

• AI 助手控制智能家居设备
• 自动化脚本与智能家居系统集成
• 开发智能家居相关的 AI 应用

工具列表

1. homeassistant_api：验证 Home Assistant API 是否在线。
2. homeassistant_get_state：获取指定实体的当前状态。
3. homeassistant_call_service：调用 Home Assistant 服务控制设备。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm
2. 从 Home Assistant 获取长期访问令牌

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @guilhermelirio/homeassistant-mpc --client claude

手动安装

1. 安装依赖：

npm install

1. 配置环境变量：

HOME_ASSISTANT_URL=http://your-home-assistant:8123
HOME_ASSISTANT_TOKEN=your_token_here

启动服务

npm start

开发模式：

npm run dev

调试方式

1. 确保环境变量配置正确
2. 使用 homeassistant_api() 测试 API 连接
3. 使用 homeassistant_get_state("light.living_room") 测试状态查询
4. 使用 homeassistant_call_service("light.living_room", "light", "turn_on") 测试服务调用

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。