AI导哈

Home Assistant 模型上下文协议服务器

Home Assistant MCP Server 是一个强大的桥梁，连接您的 Home Assistant 实例与语言学习模型（LLMs），通过模型上下文协议（MCP）实现对智能家居设备的自然语言控制和监控。该服务器提供全面的 API，用于管理整个 Home Assistant 生态系统，从设备控制到系统管理。

  • by drejom
  • 更新于
在 GitHub 查看 drejom/homeassistant-mcp

使用说明

基本能力

产品定位

Home Assistant MCP Server 是一个专为智能家居设计的中间件，旨在通过自然语言处理技术增强 Home Assistant 的功能，使其能够与语言学习模型（LLMs）无缝集成。

核心功能

  • 设备控制：通过自然语言控制任何 Home Assistant 设备
  • 🔄 实时更新：通过服务器发送事件（SSE）获取即时更新
  • 🤖 自动化管理：创建、更新和管理自动化
  • 📊 状态监控：跟踪和查询设备状态
  • 🔐 安全：基于令牌的认证和速率限制
  • 📱 移动端就绪：适用于任何支持 HTTP 的客户端

适用场景

  • 通过自然语言控制智能家居设备
  • 实时监控家居设备状态
  • 自动化家居场景管理
  • 集成 LLMs 进行智能家居控制

使用教程

使用依赖

  • Node.js 20.10.0 或更高版本
  • NPM 包管理器
  • Docker Compose 用于容器化
  • 运行的 Home Assistant 实例
  • Home Assistant 长期访问令牌
  • 安装 HACS 以使用包管理功能
  • Supervisor 访问权限以管理插件

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @drejom/homeassistant-mcp --client claude

基本设置

git clone https://github.com/jango-blockchained/homeassistant-mcp.git
cd homeassistant-mcp
npm install
npm run build

Docker 设置（推荐）

git clone https://github.com/jango-blockchained/homeassistant-mcp.git
cd homeassistant-mcp
cp .env.example .env
# 编辑 .env 文件配置
docker compose up -d

调试方式

  • 检查服务器运行状态：http://localhost:3000/health
  • 查看日志：docker compose logs -f
  • 测试 API 端点：
curl -X GET http://localhost:3000/api/state -H 'Authorization: ApiKey your_api_key_here'

相关 MCP