Home Assistant控制服务器

一个开源的MCP服务器,用于控制和查询Home Assistant设备状态。

  • by hannoeru
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 hannoeru/hass-mcp

使用说明

哈斯·麦克普

开源 MCP服务器 用于控制和查询 家庭助手.

  • 运输:stdio
  • Auth:家庭助理长寿令牌
  • API:Home Assistant REST API

特性

暴露的工具:

  • ha_get_state --获取实体的状态
  • ha_list_states --列出所有州(可以很大)
  • ha_call_service --呼叫任何服务

安装

pnpm install
pnpm build

跑

export HASS_URL="http://homeassistant.local:8123"
export HASS_TOKEN="<your long-lived access token>"

pnpm start

在MCP客户端中配置

示例(概念性):

{
  "mcpServers": {
    "homeassistant": {
      "command": "npx",
      "args": ["-y", "hass-mcp"],
      "env": {
        "HASS_URL": "http://homeassistant.local:8123",
        "HASS_TOKEN": "..."
      }
    }
  }
}

安全

  • 将代币视为秘密。
  • 更喜欢在与家庭助理相同的局域网上运行此服务器。
  • 如果您的HA支持Cloudflare Access,请在LAN侧运行此MCP服务器。

许可证

麻省理工学院