∴ GitHub / 趋势仓库
homeassistant-ai / ha-mcp
用 AI 助手配置和自动化 Home Assistant 的 MCP 服务器
- 语言
- Python
- Star
- 7.6k
- Fork
- 459
- 当日新增(11-12)
- +645
- 累计在榜
- 4 天
- 最高名次
- 第 7 名
- 首次上榜
- 2026-11-09
∴ 是什么
HA-MCP 是一个 Model Context Protocol (MCP) 服务器,让 Claude、ChatGPT 等 AI 助手能够配置和自动化 Home Assistant。它提供 87 个工具,可通过多种方式运行,包括 Home Assistant 集成(基于 HACS)、Home Assistant 应用(add-on)、Docker、PyPI 以及本地 stdio。
∴ 解决什么问题
- 让 AI 助手直接管理和操作 Home Assistant,无需手动编写自动化或配置
- 在多种 Home Assistant 安装类型(OS、Supervised、Container、Core)上统一提供 MCP 功能
- 为远程访问提供安全的 webhook 机制,避免暴露内部端口
∴ 怎么上手
- 01安装 HA-MCP 集成(需要 Home Assistant 2026.8.0 或更新版本);在 2026.8–2026.10 上通过 HACS 搜索 HA-MCP 并下载,在 2026.11+ 上通过 Settings → Marketplace 安装
- 02重启 Home Assistant
- 03决定服务器使用哪个管理员账户:创建长期访问令牌,或为 HA-MCP 创建专用账户(Settings → People → Add person)
- 04进入 Settings → Devices & Services → Add Integration,搜索 HA-MCP 并选择 HA-MCP Server,粘贴令牌或输入账户凭据,选择客户端连接方式后提交
- 05从 Configure 屏幕复制连接 URL
- 06将该 URL 粘贴到 AI 客户端中
∴ 适合谁
Home Assistant 用户,希望利用 Claude、ChatGPT 等 AI 助手来配置和自动化其智能家居系统
∴ 要点
- 提供 87 个工具
- 内置 FastMCP 构建
- 支持多种运行方式:Home Assistant 集成(HACS)、应用(add-on)、Docker、PyPI/uvx、本地 stdio
- 集成模式在 Home Assistant 进程内运行,支持所有安装类型
- 可选的 OIDC 认证,支持外部身份提供商
- MIT 许可证
许可证 MITaiclaudehacshome-assistanthome-automationllmmcpmodel-context-protocol
解读由 AI 依据项目 README 生成,生成于 2026-11-09,以 GitHub 原文为准。
∴ 在榜记录
GitHub Trending 今日榜的每日存档,日期按北京时间。2026-11-09 首次上榜,累计在榜 4 天,最高第 7 名。