Home Assistant MCP Server

基本能力

产品定位

Home Assistant MCP Server 是一个连接 MCP 生态系统与 Home Assistant 智能家居系统的桥梁，提供设备控制和状态监控功能。

核心功能

• 获取设备状态
• 控制设备开关状态（开/关）
• 触发自动化流程
• 列出可用实体

适用场景

• 通过 MCP 应用程序远程控制智能家居设备
• 监控家庭设备状态
• 自动化智能家居场景触发
• 设备管理

工具列表

1. 获取设备状态：查询指定设备/实体的当前状态
2. 切换设备状态：控制设备开关状态（开/关）
3. 触发自动化：执行预定义的自动化流程
4. 列出实体：查看系统中所有可用实体，可按域过滤

使用教程

使用依赖

1. Node.js 环境
2. Home Assistant 实例（运行中）
3. Home Assistant 长期访问令牌

安装教程

1. 克隆仓库：

git clone https://github.com/yourusername/homeassistant-server-mcp.git
cd homeassistant-server-mcp

1. 安装依赖：

npm install

1. 构建项目：

npm run build

1. 配置 MCP 服务器（编辑配置文件）：

{
  "mcpServers": {
    "homeassistant": {
      "command": "node",
      "args": ["/path/to/homeassistant-mcp/homeassistant-server/build/index.js"],
      "env": {
        "HA_URL": "http://your-homeassistant-url:8123",
        "HA_TOKEN": "your-long-lived-access-token"
      }
    }
  }
}

调试方式

1. 检查服务器是否正常运行
2. 测试基本功能：

// 获取设备状态示例
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "get_state",
  arguments: {
    entity_id: "light.living_room"
  }
});

1. 检查日志输出
2. 验证 Home Assistant 连接配置

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。