Home Assistant MCP

活跃
GitHub Python MIT

简介

Home Assistant的MCP服务器，让AI助手能够与智能家居系统交互，通过Model Context Protocol实现智能化的家居设备控制与自动化。

核心特性

  • 84+ 工具可通过自然语言控制智能家居设备、查询状态、执行服务和管理自动化
  • 多平台安装——macOS、Linux、Windows 和 Home Assistant OS 插件，提供引导式安装
  • 支持 15+ AI 客户端，包括 Claude Desktop、Claude Code、Gemini CLI、ChatGPT、VSCode 和 Cursor
  • 通过 Nabu Casa webhook 代理或 Cloudflare Tunnel 实现远程访问，安全控制家居
  • 基于 FastMCP 框架构建——快速、轻量的 Python MCP 服务器，具有端到端测试覆盖
  • 包含演示环境，无需自己的 Home Assistant 实例即可测试

适用场景

💡 通过与 AI 助手的自然语言对话控制智能家居设备和自动化
💡 使用 AI 驱动的分析调试和排查 Home Assistant 自动化问题
💡 通过对话式 UI 创建和修改 Lovelace 仪表板
💡 通过语音或文本管理家庭安防系统、照明、气候和娱乐设备
💡 无需手动编写 YAML 即可构建自定义智能家居例程和自动化

标签

python mcp tools automation api

分类

🔌 MCP 工具

快速开始

1. macOS 上运行：`curl -LsSf https://raw.githubusercontent.com/homeassistant-ai/ha-mcp/master/scripts/install-macos.sh | sh`
2. 从 claude.ai/download 下载 Claude Desktop（已安装则重启）
3. 打开 Claude 并问：'你能看到我的 Home Assistant 吗？'
4. 已连接演示环境——前往设置连接你自己的 HA 实例
5. 试试说：'打开客厅灯' 或 '创建一个日落时触发的自动化'
访问 GitHub

相关项目