作者 Coolver · Coolver/home-assistant-vibecode-agent
从 IDE 管理 Home Assistant — 使用自然语言创建自动化、设计仪表板和部署配置。
home-assistant-vibecode-agent 是一款具有 MCP 服务器集成的 Home Assistant 插件，可让 AI IDE（Claude Code、Cursor、VS Code）自主管理智能家居配置。 它可以创建自动化、设计 Lovelace 仪表板、安装 HACS 组件、管理附加组件并验证配置 - 所有这些都可以通过基于 git 的自动备份和一键回滚来实现。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"home-assistant-vibecode-agent-2": {
"command": "TODO",
"args": [
"See README: https://github.com/Coolver/home-assistant-vibecode-agent"
]
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"home-assistant-vibecode-agent-2": {
"command": "TODO",
"args": [
"See README: https://github.com/Coolver/home-assistant-vibecode-agent"
]
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"home-assistant-vibecode-agent-2": {
"command": "TODO",
"args": [
"See README: https://github.com/Coolver/home-assistant-vibecode-agent"
]
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"home-assistant-vibecode-agent-2": {
"command": "TODO",
"args": [
"See README: https://github.com/Coolver/home-assistant-vibecode-agent"
]
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "home-assistant-vibecode-agent-2",
"command": "TODO",
"args": [
"See README: https://github.com/Coolver/home-assistant-vibecode-agent"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"home-assistant-vibecode-agent-2": {
"command": {
"path": "TODO",
"args": [
"See README: https://github.com/Coolver/home-assistant-vibecode-agent"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add home-assistant-vibecode-agent-2 -- TODO 'See README: https://github.com/Coolver/home-assistant-vibecode-agent'一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 您想要在家里实现一些自动化操作，但不想手动编写 YAML。
结果： 根据简单的英语描述创建的工作家庭助理自动化。
何时使用： 您想要一个美观、实用的仪表板，但发现手动编辑器有限制。
结果： 部署到 Home Assistant 的精美 Lovelace 仪表板。
将 Home Assistant 配置导出并备份到本地文件
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| create_automation | description or YAML | 创建或修改家庭助理自动化 | 0 |
| update_dashboard | dashboard config | 创建或更新 Lovelace 仪表板 | 0 |
| list_entities | domain?: str | 列出可用的家庭助理实体 | 0 |
| call_service | domain: str, service: str, data?: obj | 呼叫家庭助理服务（打开灯、播放媒体等） | 0 |
| install_hacs | component: str | 安装 HACS 社区组件 | 0 |
Home Assistant long-lived access tokenAdd-on can't connect to Home Assistant验证长期访问令牌是否正确且尚未过期。 检查附加日志是否有连接错误。
Check Home Assistant → Settings → Add-ons for the agent's statusAutomation validation fails生成的 YAML 可能引用不存在的实体。 首先列出实体以验证名称。
list_entities to see all available entity IDsHACS component not installing确保 HACS 本身已安装在 Home Assistant 中。 检查组件名称是否正确。
Verify HACS is accessible from Home Assistant sidebar| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| Home Assistant REST API directly | 您希望无需 MCP 层即可直接访问 API | 更多控制，但没有人工智能辅助的 YAML 生成或验证 |