作者 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 AssistantVerify 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 statusAutomation validation failsThe generated YAML may reference entities that don't exist. List entities first to verify names.
list_entities to see all available entity IDsHACS component not installingEnsure 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 REST API directly | You want direct API access without the MCP layer | More control but no AI-assisted YAML generation or validation |