Model Context Protocol Server for Home Assistant

简介

这个服务器使用模型上下文协议(MCP)，允许LLM应用程序访问并控制您的本地Home Assistant实例，实现智能家居设备的自然语言控制和监控。

核心功能

• 🎮 通过自然语言控制任何Home Assistant设备
• 🔄 通过SSE获取实时更新
• 🤖 创建和管理自动化
• 📊 设备状态监控
• 🔐 安全认证机制

安装

Docker安装（推荐）

1. 克隆仓库:

   git clone https://github.com/jango-blockchained/homeassistant-mcp.git
   cd homeassistant-mcp
   

2. 配置环境:

   cp .env.example .env
   

   编辑.env文件:

   HASS_HOST=http://homeassistant.local:8123
   HASS_TOKEN=your_home_assistant_token
   HASS_SOCKET_URL=ws://homeassistant.local:8123/api/websocket
   PORT=3000
   

3. 启动服务:

   docker compose up -d
   

手动安装

# 克隆仓库
git clone https://github.com/jango-blockchained/homeassistant-mcp.git
cd homeassistant-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 运行服务器
npm start

实时更新示例

使用服务器发送事件(SSE)获取实时更新:

const eventSource = new EventSource(
  'http://localhost:3000/subscribe_events?token=YOUR_TOKEN&domain=light'
);

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Update received:', data);
};

设备控制能力

• 💡 灯光: 亮度、色温、RGB颜色
• 🌡️ 气候: 温度、HVAC模式
• 🚪 遮阳帘: 位置和倾斜控制
• 🔌 开关: 开/关控制
• 🎵 媒体播放器: 播放控制、音量
• 🔒 锁: 锁定/解锁控制
• 更多...

系统要求

• Node.js 20.10.0+
• NPM 7.0.0+
• Docker Compose (如使用Docker)
• 已运行的Home Assistant实例
• Home Assistant长期访问令牌

验证安装

访问http://localhost:3000/health检查服务器状态。

---

更多详细信息，请参阅完整文档。