项目简介

Home Assistant Vibecode Agent是一个运行在Home Assistant中的MCP服务器，为AI IDE（如Cursor、VS Code、Claude等）提供完整的智能家居管理能力，包括自动化系统构建、Lovelace仪表板设计和故障排查。

主要功能

• 智能家居配置分析：自动读取和分析Home Assistant的实体、设备和现有配置
• 自动化系统创建：根据描述生成完整的自动化、脚本和传感器系统
• 仪表板设计：编程式创建和更新Lovelace仪表板与主题
• 组件管理：创建/删除输入助手、自动化、脚本等组件
• Git版本控制：所有操作自动备份，支持查看历史记录和快速回滚
• HACS集成管理：安装、搜索和更新社区集成
• 插件管理：安装、配置和控制Home Assistant插件
• 系统监控：查看日志、检查配置状态和系统健康度

安装步骤

1. 添加仓库：在Home Assistant的"设置 → 插件 → 插件商店 → 仓库"，添加 'https://github.com/coolver/home-assistant-vibecode-agent'
2. 安装插件：刷新页面，找到"HA Vibecode Agent"并点击安装
3. 启动插件：启用"开机启动"选项并点击"启动"按钮
4. 等待启动完成（约10秒）
5. 打开Web界面：点击"打开Web UI"按钮
6. 配置IDE：按照Web界面中的Cursor或VS Code标签页说明进行配置

服务器配置

配置您的AI IDE（如Cursor）连接到这个MCP服务器：

服务器名称：home-assistant 启动命令：npx 参数：-y, @coolver/home-assistant-mcp@latest 环境变量：

• HA_AGENT_URL：http://homeassistant.local:8099
• HA_AGENT_KEY：您的API密钥（在插件Web界面中查看）

基本使用方法

连接成功后，只需用自然语言描述您的需求：

• "显示我所有的气候实体及其当前状态"
• "分析我的自动化并提出优化建议"
• "为电影模式创建一个智能照明自动化"

AI助手将自动：

1. 分析您的Home Assistant配置和设备
2. 创建所有必要的组件（自动化、脚本、传感器等）
3. 自动部署和验证更改
4. 提供完整的历史记录和回滚功能