Claude Home Assistant MCP And Claude Code Builder

克劳德+Home Assistant：双脑协作，效果更佳

别再和YAML较劲了。开始与你的智能家居对话吧。

这一集成将Claude（桌面版或代码版）与Home Assistant连接起来，将自然对话转化为仪表盘、自动化操作和智能家居管理。无需模板，无任何限制，只需描述您的需求即可。

 

______________________________________________________________________

这与众不同的地方是什么

大多数高性能计算（HA）工具迫使你学习它们的语法。而这个工具则会适应你的语法。

提问：

"Which lights are on in the living room?"
"Show me all temperature sensors that haven't updated in 24 hours"
"What automations are using the front door sensor?"

构建仪表板：

"Create a bedroom control panel - lights, temperature, and blinds.
Make it dark themed and mobile-friendly."

修复自动化流程：

"This automation isn't triggering. Here's the YAML..."
→ Claude analyzes, finds the issue, rewrites it correctly

整理你的设置：

"Rename all my Zigbee sensors to match their rooms"
"Move all kitchen devices to the Kitchen area"
"Find duplicate entities and suggest which to disable"

______________________________________________________________________

两种连接方式

🖥️ Claude 桌面版（MCP）

最适合用于： 快速查询，实体发现，简单任务

一个配置文件即可将Claude Desktop直接连接到您的家庭自动化（HA）实例。非常适合用于检查状态、查询实体以及构建简单仪表板。

设置时间： 5分钟 你需要： Node.js（用于MCP桥接）

📖 Claude 桌面版设置指南 →

______________________________________________________________________

💻 克劳德代码

最适合用于： 复杂的仪表板、自动化工作、大量的迭代

完整的对话上下文意味着Claude会记住你整个设计过程。无论你构建了什么，经过了10次的精炼，还是添加了新功能，上下文信息都不会丢失。

设置时间： 2分钟 你需要的有： 来自您集成配置的API密钥

📖 克劳德代码指南 →

______________________________________________________________________

真实案例

示例1：仪表盘演变

你： *“用我的灯光打造一个客厅控制面板”*

✓ Claude queries your entities
✓ Finds 4 lights, 2 switches (that control lights)
✓ Creates custom web dashboard with toggle controls

\[截图占位符：初始仪表盘，包含6个简单的灯光切换开关\]

你： *“把按钮做得更大一些，并添加亮度滑块”*

✓ Claude remembers the layout
✓ Updates button size to 20% larger
✓ Adds sliders for dimmable lights

\[截图占位符：同一仪表板，按钮更大，增加了滑块\]

你： *“添加温度传感器，并将其主题设为深色”*

✓ Finds sensor.living_room_temperature
✓ Adds large temperature display at top
✓ Switches to dark theme (grays/blacks)

\[截图占位符：暗色主题仪表盘，带有温度显示和控制功能\]

你： *“实际上，我们能不能用原生的Lovelace仪表盘来做这件事呢？”*

✓ Claude converts the design to Lovelace YAML
✓ Creates native dashboard in your sidebar
✓ No browser refresh needed—appears immediately

\[截图占位符：Home Assistant（HA）侧边栏中的原生Lovelace版本\]

______________________________________________________________________

示例2：自动化医生

你： *“我在更新HA后，这个自动化功能就失效了。你能帮忙看看吗？”*

- alias: "Porch light at sunset"
  trigger:
    platform: sun
    event: sunset
  action:
    service: light.turn_on
    entity_id: light.porch

克劳德分析道：

Found the issue: 'trigger' should be a list, not a dict.
The sun platform syntax changed in HA 2024.x

Here's the fixed version:

- alias: "Porch light at sunset"
  trigger:
    - platform: sun
      event: sunset
  action:
    - service: light.turn_on
      target:
        entity_id: light.porch

\[截图占位符：并排YAML比较，突出显示更改和注释\]

克劳德能：

• 修复损坏的自动化流程
• 解释他们为何破裂
• 提出改进建议（条件、优化）
• 根据描述创建全新的自动化流程
• 在部署前测试自动化逻辑

______________________________________________________________________

示例3：实体清理

你： *“我的实体清单乱成一团。帮我整理一下卧室里的设备。”*

克劳德询问您的实体信息：

Found 47 entities in Bedroom area:
- 12 sensors (temperature, humidity, motion, etc.)
- 8 lights (including 3 switches)
- 2 climate devices
- 25 diagnostic/battery sensors from devices

你： *“将温度传感器重命名以使其更清晰，并在用户界面中隐藏电池传感器”*

✓ Renames sensor.temp_1 → sensor.bedroom_main_temperature
✓ Renames sensor.temp_2 → sensor.bedroom_closet_temperature
✓ Hides 25 battery/diagnostic entities from UI (keeps in backend)
✓ Logs all changes for review

\[截图占位符：实体列表的前后对比，显示重命名的项目和隐藏的诊断实体\]

______________________________________________________________________

你能构建什么

原生Lovelace仪表板

在您的高可用性（HA）侧边栏中实现真正的仪表板——可在用户界面中编辑，支持所有原生卡片类型。

使用时机： 您想要高可用性（HA）原生功能、用户界面编辑和标准卡片

\[截图占位符：带有实体、仪表和按钮卡片的原生Lovelace仪表板\]

______________________________________________________________________

定制网页仪表板

独立的HTML页面，设计自由度无限。可使用任何CSS框架、任何JavaScript库、任何布局。

使用时机： 您需要完全的控制权、自定义的可视化效果以及品牌设计

\[截图占位符：自定义网页仪表板，具有独特布局、CSS网格和自定义图表\]

______________________________________________________________________

自动化

通过对话创建、调试和修复自动化流程。Claude理解Home Assistant（HA）的自动化语法，并能识别常见错误。

示例：

• “当湿度 > 70% 时打开浴室换气扇，当湿度 \< 50% 时关闭”
• “若处于警戒状态时前门打开，则所有灯闪烁红色”
• “如果车库门开启超过30分钟，请发送通知”

\[截图占位符：终端显示通过自然语言输入创建自动化的过程\]

______________________________________________________________________

实体管理

重命名实体，分配区域，隐藏用户界面元素，查找孤立设备。

示例：

• “显示所有不可用的实体”
• “哪些实体在48小时内未报告？”
• “将所有卧室传感器移到主卧室区域”

\[截图占位符：实体管理界面，展示批量操作功能\]

______________________________________________________________________

安装

1. 通过HACS安装

1. 开放 HACS（假设为某组织或系统的缩写，具体含义需根据上下文确定） → 集成（或整合）
2. 点击 ⋮ 菜单 → 自定义仓库
3. 添加仓库： https://github.com/tomganleylee/HA-Claude-Dashboard-Builder
4. 点击 下载
5. 重启Home Assistant

______________________________________________________________________

2. 添加集成

1. 设置 → 设备与服务 → 添加集成
2. 搜索： “Claude Dashboard Builder”翻译为中文是“Claude仪表板构建器”
3. 完成安装向导
4. 复制您的API密钥 （你将需要这个用于Claude代码）

______________________________________________________________________

3. 连接克劳德

对于Claude Desktop： 遵循 Claude 桌面版安装指南 （5分钟，需要Node.js）

对于克劳德·科德： 只需与Claude Code分享这些：

Home Assistant URL: http://YOUR_HA_IP:8123
API Key: [paste from integration config]
Repo: https://github.com/tomganleylee/HA-Claude-Dashboard-Builder

______________________________________________________________________

一目了然的功能概览

______________________________________________________________________

屏幕截图

仪表盘进化（多轮对话）

\[占位符：四面板流程图，展示通过对话不断优化仪表板的过程\]

______________________________________________________________________

原生Lovelace + 自定义网页（并排显示）

\[占位符：浏览器窗口，包含两个标签页 - HA Lovelace仪表板和自定义网页仪表板\]

______________________________________________________________________

自动化救援（前后对比）

\[占位符：错误高亮显示的损坏YAML，然后是附带解释的修复版本\]

______________________________________________________________________

实体组织（行动中的清理工作）

\[占位符：杂乱无章的实体列表转变为有序且命名规范的实体\]

______________________________________________________________________

Claude Desktop MCP 工具

\[占位符：Claude桌面界面显示包含实体查询的HA工具面板\]

______________________________________________________________________

移动响应式设计

!\[占位符：同一自定义仪表板在桌面、平板电脑和手机上的显示\]

______________________________________________________________________

完整功能列表

🔍 发现与查询

• 列出所有实体（带分页功能，按领域/区域过滤）
• 获取实体状态和属性
• 通过名称、领域或区域查找实体
• 识别不可用或过时的实体
• 查询区域和设备信息

🎨 仪表板创建

• 原生Lovelace仪表板 （出现在侧边栏，可编辑用户界面）

- 所有标准卡片类型（实体、仪表、按钮、恒温器等） - 支持视图、章节、YAML配置 - 从自然语言或YAML创建

• 定制网页仪表盘 （独立HTML页面）

- 任何HTML/CSS/JavaScript - 实时WebSocket更新 - 任何CSS框架（Tailwind、Bootstrap、自定义） - 自定义图表和可视化展示

• 列出、更新和删除两种仪表板类型
• 模板库（预构建示例）

🤖 自动化管理

• 根据描述创建自动化流程
• 修复损坏的自动化流程
• 修复语法错误和弃用的语法
• 提出改进建议和优化方案
• 启用/禁用自动化
• 列出并分析现有的自动化流程

🏠 实体管理

• 重命名实体（友好名称或实体ID）
• 将实体分配到区域
• 在用户界面中隐藏实体（保留在后端）
• 批量操作（批量重命名，移动到区域）
• 查找重复或孤立的实体

🗂️ 区域管理

• 创建新区域
• 更新区域名称和元数据
• 将设备和实体分配到各个区域
• 列出所有区域及其实体

🔐 安全

• API密钥认证
• HTML/CSS/JS 清理（用于自定义仪表板）
• XSS（跨站脚本攻击）和路径遍历防护
• 安全的WebSocket连接

______________________________________________________________________

建筑

Claude Desktop（MCP）

┌──────────────────┐
│ Claude Desktop   │ stdio (local process)
│                  │
└────────┬─────────┘
         │
         ▼
┌──────────────────┐
│  MCP Bridge      │ npx @modelcontextprotocol/server-home-assistant
│  (Node.js)       │
└────────┬─────────┘
         │ HTTP
         ▼
┌──────────────────┐
│ Home Assistant   │ Integration API
│ + This Integration│
└──────────────────┘

“Claude Code (HTTP API)”

┌──────────────────┐
│   Claude Code    │ Direct HTTP requests
│   (IDE + Agent)  │
└────────┬─────────┘
         │ HTTP + API Key
         ▼
┌──────────────────┐
│ Home Assistant   │ Integration API
│ + This Integration│
└──────────────────┘

______________________________________________________________________

文档

• 克劳德编码指南 - 完整的HTTP API参考、示例、工作流程
• Claude 桌面版设置 - MCP配置，故障排除
• 模板 - 预建仪表板示例

______________________________________________________________________

要求

• 家庭助手（Home Assistant）： 2023年1月0日或更新版本
• 对于MCP（Claude桌面版）： Node.js 18+（提供 npx）
• 对于HTTP API（Claude代码）： 无其他要求

______________________________________________________________________

为何存在这一现象

Home Assistant功能强大，但有一定学习门槛。YAML语法严谨，不容许任何疏忽。用户界面实用但有所局限。

这种集成为您提供了一个协作伙伴，该伙伴：

• 能说自然语言
• 了解HA（高可用性）的内部机制
• 记住您整个的对话（克劳德代码）
• 修正错误，而非抛出错误
• 按照您的描述准确构建

它并不是要取代HA用户界面或YAML——而是提供了一种第三种工作方式。有时候你想要使用用户界面，有时候你想要用YAML进行控制，有时候你只想描述你的需求，然后让系统为你构建。

______________________________________________________________________

故障排除

Claude Desktop无法连接

• 验证是否已安装 Node.js： npx --version
• 在Claude桌面设置中检查您的MCP配置
• 确保可以通过配置的URL访问Home Assistant
• 检查HA中的集成日志

自定义仪表板无法加载

• 验证集成配置中的托管方式（面板 vs 网络服务器）
• 检查浏览器控制台中的错误
• 确保WebSocket连接不会被防火墙阻止

Lovelace仪表板未显示

• 检查HA日志中的WebSocket错误
• 确保已启用存储模式（默认设置）
• 尝试使用 Ctrl+F5 刷新浏览器

自动化未能创建

• 验证自动化语法是否为有效的HA YAML
• 检查目标实体是否存在
• 检查HA日志中的自动化错误

全面的故障排除指南： 故障排除指南.md

______________________________________________________________________

贡献

欢迎提出拉取请求（PRs）！感兴趣的领域：

• 额外的仪表板模板
• 增强的自动化验证
• 增强实体发现
• 额外的MCP工具
• 文档改进

见 \CONTRIBUTING.md\ 翻译成中文是“贡献指南.md” 作为指导方针。

______________________________________________________________________

支持

• 问题：
• 讨论：
• Home Assistant 社区： 社区论坛帖子

______________________________________________________________________

许可证

MIT 许可证 - 请参阅 许可证 详情请见文件。

______________________________________________________________________

为Home Assistant社区倾情打造

*因为智能家居应该理解你，而不是你去理解它。*