Home Assistant MCP Server

简介

Home Assistant MCP 服务器允许您通过 Model Context Protocol (MCP) 与您的 Home Assistant 智能家居系统进行交互。详情请访问 www.aimcp.info。

安装步骤

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 实例
• 保护好您的访问令牌，不要将其提交到版本控制系统
• 定期更换访问令牌
• 使用环境变量存储敏感信息

获取帮助

如有问题，请查看 GitHub 仓库的 Issues 或访问 www.aimcp.info 获取支持。