Home Assistant MCP Server

社区

用自然语言从 IDE 中管理你的 Home Assistant：自动化、仪表盘、主题和配置。

分类: 开发工具第 362 / 438
Stars: ★ 58 热门
传输方式: stdio（本地进程）
运行环境: Node.js 20.0.0+ · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 5 个月前
工具数: 7

39FMRS · D

该 MCP 服务器通过提供与 Home Assistant 代理的受控 API 集成，为管理 Home Assistant 提供了独特的方法。它适合希望利用 AI 辅助自动化的开发者，但需要额外的代理插件。主要风险是密钥管理和对 AI 生成的配置更改的依赖。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 4/20

可靠性

4/20

安全与权限

6/20

维护活跃度

8/20

文档质量

9/20

安装易用性

12/20

查看各项评分依据

可靠性 4/20: 证据：manifest 声明了 npm 包 @coolver/home-assistant-mcp 版本 3.2.31、stdio 传输以及必需环境变量；README 描述了分析、创建自动化、仪表盘、主题、部署等功能。扣除：未提供任何源代码、CI 或测试，无法验证 MCP 初始化握手和工具列表是否真实一致；对 HA Agent 的依赖和错误处理缺少可复现证据。按静态校准要求，可靠性最高不超过 12，因此保守给 4。
安全与权限 6/20: 证据：HA_AGENT_KEY 在 manifest 中标记为 secret，README 警告不要把含密钥的 mcp.json 提交到 git；架构通过本地 agent 的 REST API 端口 8099 通信，并有 Git 版本化和回滚说明。扣除：没有看到最小权限模型或对部署/删除等写操作的显式确认；README 描述 AI 自动部署变更到 Home Assistant，默认即产生远程副作用；HTTP 传输和密钥轮换细节未证实。未触发红色底线（示例中无真实密钥），但评分仍低，给 6。
维护活跃度 8/20: 证据：仓库未存档，声明 MIT 许可证，版本号 3.2.31 且 README 中列出 CHANGELOG.md。扣除：没有提交历史、发布频率、依赖更新、issue 响应或安全通告渠道等可核实证据；维护活跃度仅能从当前元数据推断，治理和版本策略不清晰，因此给 8。
文档质量 9/20: 证据：README 提供先决条件、快速开始、环境变量表、mcpServers 配置示例、故障排查、架构和安全提醒。扣除：缺少工具参数说明、使用限制和成本信息；相关项目链接存在不一致（cursor-agent 与 vibecode-agent 混用）；且 README 属于不可信证据，不能替代对真实行为和接口的验证，因此给 9。
安装易用性 12/20: 证据：README 给出了从 Node.js 安装、HA Vibecode Agent add-on 安装、IDE 中配置 MCP 到测试连接的步骤，并包含具体的 mcpServers JSON 示例。扣除：安装依赖另一个 add-on 的 Web UI，需要手动复制密钥和设置环境变量；没有 CI 或已提交测试证明端到端可执行，按静态校准 setup 最高不超过 15，保守给 12。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络

适合谁

希望从 Cursor、VS Code 或 Claude Code 等 AI 驱动的 IDE 中管理 Home Assistant 的开发者。
希望使用 AI 快速构建和迭代自动化或仪表盘，同时保留手动控制权的人。
那些需要强大、可预测的 API 访问 Home Assistant，而不是依赖 SSH 或临时脚本的用户。

不适合谁

没有安装 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 20.0.0+ · Docker

HA_AGENT_URL 必填 HA Vibecode Agent 插件的 URL（安装插件后生成），默认 http://homeassistant.local:8099。

HA_AGENT_KEY 必填密钥由 HA Vibecode Agent 插件首次启动时自动生成的访问密钥，可在插件 Web UI 中查看或重新生成。

在 Home Assistant 中安装并启动 HA Vibecode Agent 插件（v2.0.0+）。
从插件 Web UI 获取代理密钥。
在你的 AI 编辑器中配置 MCP 客户端，指定命令 'npx -y @coolver/home-assistant-mcp@latest'，并设置环境变量 HA_AGENT_URL 和 HA_AGENT_KEY。
重启你的 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"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "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"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add home-assistant -e 'HA_AGENT_URL=http://<home-assistant-host>:8099' -e HA_AGENT_KEY=your_api_key_here -- npx -y @coolver/home-assistant-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 AI 编辑器中发送：连接到我的 Home Assistant，列出所有 climate 实体并显示 Agent 状态；如果返回实体列表和 Agent 状态，说明连接成功。

常见排障

检查 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 中。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

连接到我的 Home Assistant，列出所有 climate 实体并显示 HA Vibecode Agent 的当前状态
为我的散热器安装智能温控方案
为我创建一个客厅的 Lovelace 仪表盘，包含历史图表卡片
安装并配置某个 HACS 集成，然后部署配置更改

工具能力 7

read config 只读

读取整个 Home Assistant 配置，包括实体、自动化、脚本和辅助元素。

analyze entities 只读

分析设备的功能、关系和用法模式。

create automations 写入

基于实际实体、区域和设备创建并优化自动化脚本和完整系统。

design dashboards 写入

以编程方式创建、更新 Lovelace 仪表盘，控制卡片、布局和视图。

tweak themes 写入

创建和修改主题，以个性化用户界面。

deploy changes 写入

以 Git 版本控制的方式安全地部署更改，并支持回滚。

install HACS integrations 写入

安装和管理 HACS 集成和自定义存储库。

使用场景

使用自然语言创建复杂的智能家居自动化，例如“为我的散热器安装智能气候控制”。

无需手动编辑 YAML，直接从 IDE 设计或修改 Lovelace 仪表盘。

基于实际实体和模式，审查和分析现有配置以进行优化。

安全地部署更改，自动进行 Git 版本控制，并在出现问题时回滚。

支持客户端

Claude Desktop

Cursor

VS Code

依据项目文档列出，未经本站实测。

详细介绍

这是一个 MCP 服务器，它需要与 Home Assistant Vibecode Agent（作为 Home Assistant 插件运行）配合使用。该代理在你的 Home Assistant 实例上运行，并通过 REST API 提供对内部 API、文件和服务的访问。MCP 服务器在你的本地计算机上运行，并与你的 AI IDE（如 Cursor、VS Code 或 Claude Code）通信，将你的自然语言请求转换为代理可执行的操作。它支持读取配置、创建自动化、设计 Lovelace 仪表盘、自定义主题以及安全部署更改。