homeassistant-ai/ha-mcp

项目概览

将 AI 助手与 Home Assistant 的交互范围从执行设备指令扩展至自动化逻辑配置、仪表盘编辑与系统调试。

项目类型

MCP · AI Agent

应用场景

文档办公 · 自动化执行

部署方式

查看项目说明

License

MIT

适合谁

• 希望利用 AI 助手进行高级系统配置和自动化调试的 Home Assistant 用户。
• 希望集成多种 AI 客户端且无需额外采购 GPU 的普通用户或开发者。

核心能力

• 允许 AI 创建、编辑、调试并管理自动化规则、脚本、辅助元素和蓝图，使用户能够通过对话形式构建和调整智能家居联动逻辑。
• 支持通过 AI 请求构建和编辑 Home Assistant 的 Lovelace 仪表盘，提供界面搭建的辅助途径。
• 通过 BM25 搜索接口隐藏完整的工具目录，帮助上下文窗口较小的 LLM 规避上下文长度限制，以发现并调用所需功能。
• 打包 Home Assistant 的领域知识作为 MCP 资源供 AI 使用，为助手操作提供系统相关的知识背景。
• 提供具备特权的文件系统访问和 YAML 配置编辑工具。注意：此功能目前处于实验阶段。

限制与风险

• stdio 传输方式存在已知的连接问题，官方不建议在实际的生产部署环境中使用。
• 如果为同一个 AI 客户端运行了多种安装方法，会导致实例冲突并引发连接挂起问题。
• 具备特权的文件系统访问和 YAML 配置编辑工具目前仍处于实验性阶段，使用需谨慎。

如何开始

• 推荐通过 HACS 安装自定义组件，重启 Home Assistant 后添加集成并复制连接 URL，最后将 URL 粘贴到 AI 客户端以完成配置，过程不需要编写代码。

替代方案与同类比较

• 一个源码可用的 AI 代理和工作流自动化构建平台。与 ha-mcp 专注于 Home Assistant 不同，n8n 提供可视化画布、自定义代码和 1500 多种集成，适合跨平台、多步骤的 AI 工作流编排。

同类比较

• homeassistant-ai/ha-mcp vs n8n

核验依据

• GitHub 项目简介: The Unofficial and Awesome Home Assistant MCP Server
• README: A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with Home Assistant.
• README: Using natural language, control smart home devices, query states, execute services and manage your automations.
• README: Built with FastMCP
• README: The recommended way to run ha-mcp is the **HA-MCP Custom Component**. It installs into Home Assistant through HACS, runs the full server **in-process**

来源更新时间：2026-07-08T01:37:26Z

打开原始 GitHub 项目