Home Assistant MCP 服务器快速开始指南

📋 概述

这是一个将 Home Assistant 智能家居功能与 Model Context Protocol (MCP) 集成的服务器，支持灯光、气候、锁、报警和加湿器等设备控制。

🔧 设置步骤

1. 环境配置

在根目录创建 .env 文件：

HOMEASSISTANT_TOKEN=your_long_lived_access_token_here
HOMEASSISTANT_BASE_URL=your_home_assistant_url_here  # 如 http://homeassistant.local:8123

2. 配置 Claude 桌面应用

MacOS 配置文件

路径：~/Library/Application Support/Claude/claude_desktop_config.json

Windows 配置文件

路径：%APPDATA%/Claude/claude_desktop_config.json

添加以下配置：

"mcpServers": {
  "home-assistant-server": {
    "command": "uvx",
    "args": [
      "home-assistant-server"
    ]
  }
}

🧰 支持的功能

目前支持的设备与功能：

• 💡 灯光：开关、亮度控制
• 🌡️ 气候：温度调节、HVAC模式
• 🔒 锁：锁定/解锁
• 🚨 报警面板：布防/撤防
• 💧 加湿器：湿度控制

示例工具：

light-turn_on()
climate-turn_off()
alarm_control_panel-disarm()
lock-lock()
humidifier-turn_off()

🔍 调试

推荐使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uv --directory /path/to/home-assistant-server run home-assistant-server

📦 开发者信息

构建和发布：

# 同步依赖
uv sync

# 构建包
uv build

# 发布到 PyPI
uv publish

📄 许可

MIT 许可证