hass-mcp

MCP-сервер с открытым исходным кодом для управления и получения данных из Home Assistant.

• Транспорт: stdio

• Авторизация: долгоживущий токен Home Assistant

• 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": "..."
      }
    }
  }
}

Безопасность

• Относитесь к токенам как к секретным данным.

• Рекомендуется запускать этот сервер в той же локальной сети, что и Home Assistant.

• Если ваш HA находится за Cloudflare Access, запускайте этот MCP-сервер на стороне локальной сети.

Лицензия

MIT