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 對比其他方案

更多

資源