∴ GitHub / 趋势仓库

homeassistant-ai / ha-mcp

用 AI 助手配置和自动化 Home Assistant 的 MCP 服务器

语言
Python
Star
7.6k
Fork
459
当日新增(11-12)
+645
累计在榜
4 天
最高名次
第 7 名
首次上榜
2026-11-09
去 GitHub 查看 ↗项目主页 ↗

∴ 是什么

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 机制,避免暴露内部端口

∴ 怎么上手

  1. 01安装 HA-MCP 集成(需要 Home Assistant 2026.8.0 或更新版本);在 2026.8–2026.10 上通过 HACS 搜索 HA-MCP 并下载,在 2026.11+ 上通过 Settings → Marketplace 安装
  2. 02重启 Home Assistant
  3. 03决定服务器使用哪个管理员账户:创建长期访问令牌,或为 HA-MCP 创建专用账户(Settings → People → Add person)
  4. 04进入 Settings → Devices & Services → Add Integration,搜索 HA-MCP 并选择 HA-MCP Server,粘贴令牌或输入账户凭据,选择客户端连接方式后提交
  5. 05从 Configure 屏幕复制连接 URL
  6. 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 名。

[object Object]2026-11-09 +312026-11-10 +7922026-11-11 +6402026-11-12 +645
每日新增 Star · 2026-11-09 至 2026-11-12 · 共 4 个在榜日峰值 +792
日期名次当日新增总 Star
#8+6457,570
#8+6407,079
#7+7926,414
#10+315,581