Home Assistant MCP Server

概述

通过此 MCP 服务器控制和监控您的 Home Assistant 智能家居设备，支持查询设备状态、控制设备、触发自动化和列出可用实体。

安装步骤

1. 克隆仓库并安装

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

2. 配置 MCP 服务器
   在您的 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"
         }
       }
     }
   }
   

使用工具

获取设备状态

use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "get_state",
  arguments: {
    entity_id: "light.living_room"
  }
});

切换设备状态

use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "toggle_entity",
  arguments: {
    entity_id: "switch.bedroom",
    state: "on"  // 或 "off"
  }
});

触发自动化

use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "trigger_automation",
  arguments: {
    automation_id: "automation.morning_routine"
  }
});

列出实体

use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "list_entities",
  arguments: {
    domain: "light"  // 可选，按域过滤
  }
});

安全提示

• 使用 HTTPS 保护您的 Home Assistant 实例
• 妥善保管访问令牌，定期更换
• 使用环境变量存储敏感信息

更多资源

• MCP 文档: www.aimcp.info
• 遇到问题请查看仓库中的已知问题或创建新问题