home-assistant-vibecode-agent MCP — 使用场景, 安装 & 实时演示

为什么要用

核心特性

Natural language automation creation and debugging
Lovelace dashboard design and theme customization via AI
Git-based automatic backups with meaningful commit messages and rollback
HACS integration for installing 1000+ community components
Full HA REST API and WebSocket access with configuration validation

实时演示

实际使用效果

home-assistant-vibecode-agent-2.replay ▶ 就绪

0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %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。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "home-assistant-vibecode-agent-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "home-assistant-vibecode-agent-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "home-assistant-vibecode-agent-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "home-assistant-vibecode-agent-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/Coolver/home-assistant-vibecode-agent"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "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 卸载。

使用场景

实战用法： home-assistant-vibecode-agent

How to create a Home Assistant automation with natural language

👤 Smart home enthusiasts who prefer describing what they want over writing YAML ⏱ ~10 min beginner

何时使用： You want to automate something in your home but don't want to write YAML manually.

前置条件

Home Assistant with the add-on installed — Add repository https://github.com/coolver/home-assistant-vibecode-agent and install
MCP client configured — Configure Claude Code or Cursor to connect to the add-on's MCP endpoint

步骤

Describe your automation

Create an automation: when I arrive home (phone GPS enters home zone), turn on the living room lights, set them to 70% brightness, and start playing my Spotify playlist on the kitchen speaker.✓ 已复制

→ Automation YAML generated and validated
Deploy and test

Deploy this automation and trigger a test run.✓ 已复制

→ Automation deployed with backup created and test results

结果： A working Home Assistant automation created from a plain English description.

注意事项

Entity names don't match what you described — Ask the agent to list available entities first so you can reference the correct names

Design a custom Lovelace dashboard with AI

👤 Home Assistant users who want better dashboards without learning Lovelace YAML ⏱ ~20 min intermediate

何时使用： You want a beautiful, functional dashboard but find the manual editor limiting.

前置条件

Vibecode agent running and connected — Install add-on and configure MCP client

步骤

Describe the dashboard

Design a dashboard for my bedroom: show temperature/humidity from the sensor, light controls with brightness sliders, a media player card for the Sonos, and a graph of temperature over the last 24 hours.✓ 已复制

→ Lovelace YAML generated with all requested cards
Iterate on design

Move the media player to the top and add a dark theme that matches my bedroom colors.✓ 已复制

→ Updated dashboard with reordered cards and custom theme

结果： A polished Lovelace dashboard deployed to Home Assistant.

注意事项

Custom cards require HACS installation — Ask the agent to install required HACS components before adding custom cards

组合

与其他 MCP 搭配，撬动十倍杠杆

home-assistant-vibecode-agent-2 + filesystem

Export and backup Home Assistant configurations to local files

Export all my automations and dashboard configs to ~/ha-backup/ for version control.✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用
create_automation	description or YAML	Create or modify Home Assistant automations
update_dashboard	dashboard config	Create or update Lovelace dashboards
list_entities	domain?: str	List available Home Assistant entities
call_service	domain: str, service: str, data?: obj	Call a Home Assistant service (turn on lights, play media, etc.)
install_hacs	component: str	Install a HACS community component

成本与限制

运行它的成本

API 配额: N/A — communicates with local Home Assistant instance
每次调用 Token 数: 200–1000 tokens per operation
费用: Free — open source add-on
提示: List entities first to reduce trial-and-error when creating automations.

安全

权限、密钥、影响范围

最小权限： Home Assistant long-lived access token

凭据存储： HA access token configured in the add-on settings

数据出站： Communicates with your local Home Assistant instance only. HACS downloads from GitHub.

This add-on has full access to your Home Assistant API. It can control all devices, modify configurations, and install components.
Always verify automation YAML before deploying — bad automations can trigger devices unexpectedly.
Git backup provides rollback, but test changes on non-critical devices first.

故障排查

常见错误与修复

Add-on can't connect to Home Assistant

Verify the long-lived access token is correct and hasn't expired. Check the add-on logs for connection errors.

验证： Check Home Assistant → Settings → Add-ons for the agent's status

Automation validation fails

The generated YAML may reference entities that don't exist. List entities first to verify names.

验证： list_entities to see all available entity IDs

HACS component not installing

Ensure HACS itself is installed in Home Assistant first. Check that the component name is correct.

验证： Verify HACS is accessible from Home Assistant sidebar

替代方案

home-assistant-vibecode-agent 对比其他方案

替代方案	何时用它替代	权衡
Home Assistant REST API directly	You want direct API access without the MCP layer	More control but no AI-assisted YAML generation or validation

home-assistant-vibecode-agent

为什么要用

核心特性

实时演示

实际使用效果

安装

选择你的客户端

使用场景

实战用法： home-assistant-vibecode-agent

How to create a Home Assistant automation with natural language

前置条件

步骤

注意事项

Design a custom Lovelace dashboard with AI

前置条件

步骤

注意事项

组合

与其他 MCP 搭配，撬动十倍杠杆

工具

此 MCP 暴露的能力

成本与限制

运行它的成本

安全

权限、密钥、影响范围

故障排查

常见错误与修复

替代方案

home-assistant-vibecode-agent 对比其他方案

更多

资源