适合谁
- 希望从 Cursor、VS Code 或 Claude Code 等 AI 驱动的 IDE 中管理 Home Assistant 的开发者。
- 希望使用 AI 快速构建和迭代自动化或仪表盘，同时保留手动控制权的人。
- 那些需要强大、可预测的 API 访问 Home Assistant，而不是依赖 SSH 或临时脚本的用户。
H
39FMRS · D
该 MCP 服务器通过提供与 Home Assistant 代理的受控 API 集成，为管理 Home Assistant 提供了独特的方法。它适合希望利用 AI 辅助自动化的开发者，但需要额外的代理插件。主要风险是密钥管理和对 AI 生成的配置更改的依赖。
这是一个 MCP 服务器，它需要与 Home Assistant Vibecode Agent（作为 Home Assistant 插件运行）配合使用。该代理在你的 Home Assistant 实例上运行，并通过 REST API 提供对内部 API、文件和服务的访问。MCP 服务器在你的本地计算机上运行，并与你的 AI IDE（如 Cursor、VS Code 或 Claude Code）通信，将你的自然语言请求转换为代理可执行的操作。它支持读取配置、创建自动化、设计 Lovelace 仪表盘、自定义主题以及安全部署更改。
工具能力
read config
读取整个 Home Assistant 配置，包括实体、自动化、脚本和辅助元素。
analyze entities
分析设备的功能、关系和用法模式。
create automations
基于实际实体、区域和设备创建并优化自动化脚本和完整系统。
design dashboards
以编程方式创建、更新 Lovelace 仪表盘，控制卡片、布局和视图。
tweak themes
创建和修改主题，以个性化用户界面。
deploy changes
以 Git 版本控制的方式安全地部署更改，并支持回滚。
install HACS integrations
安装和管理 HACS 集成和自定义存储库。
安装接入
- 在 Home Assistant 中安装并启动 HA Vibecode Agent 插件（v2.0.0+）。2. 从插件 Web UI 获取代理密钥。3. 在你的 AI 编辑器中配置 MCP 客户端，指定命令 'npx -y @coolver/home-assistant-mcp@latest'，并设置环境变量 HA_AGENT_URL 和 HA_AGENT_KEY。4. 重启你的 AI 编辑器并测试连接。
claude_desktop_config.json
{
"mcpServers": {
"home-assistant": {
"command": "npx",
"args": [
"-y",
"@coolver/home-assistant-mcp@latest"
],
"env": {
"HA_AGENT_URL": "http://<home-assistant-host>:8099",
"HA_AGENT_KEY": "your_api_key_here"
}
}
}
}
选型与风险
不适合谁
- 没有安装 HA Vibecode Agent 插件，或不希望在 Home Assistant 中运行额外自定义组件的用户。
- 需要 REST API 或 WebSocket 直接访问 Home Assistant，而不通过代理的用户。
- 不想在本地安装 Node.js 或使用 MCP 协议的初学者。
所需权限
- 需要访问本地文件系统（用于运行 Node.js 和 npx）。
- 需要网络访问 Home Assistant 代理的端口（通常为 8099）。
- 需要环境变量 HA_AGENT_URL 和 HA_AGENT_KEY 来验证代理。
- 代理本身使用 Home Assistant 的 SUPERVISOR_TOKEN 访问内部 API。
风险与副作用
- 将代理密钥存储在 mcp.json 中，如果提交到 git，可能会泄露。
- AI 生成的操作可能修改或删除配置，可能导致数据丢失，尽管有 Git 版本控制。
- 依赖自定义代理运行在 Home Assistant 内部，可能会引入安全漏洞，如果暴露在不受信任的网络上。
- 如果配置错误，可能无意中影响生产环境。
常见排障
- 检查 Node.js 是否已安装（版本不低于 v20.0.0）。
- 验证 HA Vibecode Agent 插件是否已安装并在 Home Assistant 中运行。
- 检查 HA_AGENT_URL 和 HA_AGENT_KEY 环境变量是否正确。
- 尝试在浏览器中访问代理的 /api/health 端点，或使用 curl 命令检查。
- 如果出现“spawn npx ENOENT”错误，请确保 Node.js 在系统 PATH 中。
使用场景
使用自然语言创建复杂的智能家居自动化，例如“为我的散热器安装智能气候控制”。
无需手动编辑 YAML，直接从 IDE 设计或修改 Lovelace 仪表盘。
基于实际实体和模式，审查和分析现有配置以进行优化。
安全地部署更改，自动进行 Git 版本控制，并在出现问题时回滚。
支持客户端
Claude Desktop完整支持
Cursor完整支持
VS Code完整支持