KOVA MCP

Общайтесь со своим myGEKKO. MCP-сервер с открытым исходным кодом MCP, который связывает Claude (и любой другой MCP-клиент) с контроллерами зданий myGEKKO — через официальный myGEKKO Query API. Общайтесь со своим контроллером зданий myGEKKO через Claude — английское краткое руководство ниже.

«Как тепло в гостиной?» · «Какие светильники ещё включены?» · «Опусти рольставни на южной стороне» — своими словами, напрямую в свой дом.

KOVA MCP — это инструмент для энтузиастов и продвинутых пользователей. Кому нужно это каждый день, на телефоне и для всей семьи, — без терминала: это KOVA App (gekkobrain.beikma.com).

Как попробовать за 2 минуты — без собственного контроллера

Публичный демо-контроллер myGEKKO («Mustermann») создан как раз для таких тестов:

claude mcp add mygekko \
  --env GEKKO_USERNAME=mustermann@my-gekko.com \
  --env GEKKO_KEY=HjR9j4BrruA8wZiBeiWXnD \
  --env GEKKO_GEKKOID=K999-7UOZ-8ZYZ-6TH3 \
  -- uvx --from git+https://github.com/joeexafionbot-dev/kova-mcp mygekko-mcp

Затем в Claude Code: «Какие системы есть в моём здании? Покажи мне светильники в гостиной.»

Со своим собственным myGEKKO

Условие: контроллер зарегистрирован на my-gekko.com и активирован сервис Plus «myGEKKO Query API» (входит в Home Bundle; ключ создаётся в Настройки → Глобус → Plus-расширения → Plus Query API → Управление → Сгенерировать заново).

claude mcp add mygekko \
  --env GEKKO_USERNAME=deine@mail.de \
  --env GEKKO_KEY=DEIN-QUERY-API-KEY \
  --env GEKKO_GEKKOID=XXXX-XXXX-XXXX-XXXX \
  -- uvx --from git+https://github.com/joeexafionbot-dev/kova-mcp mygekko-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mygekko": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/joeexafionbot-dev/kova-mcp", "mygekko-mcp"],
      "env": {
        "GEKKO_USERNAME": "deine@mail.de",
        "GEKKO_KEY": "DEIN-QUERY-API-KEY",
        "GEKKO_GEKKOID": "XXXX-XXXX-XXXX-XXXX"
      }
    }
  }
}

Также возможна локальная работа (LAN вместо облака): GEKKO_MODE=local + GEKKO_LOCAL_HOST — все переменные в .env.example.

Что умеет сервер

Безопасность (намеренно консервативная)

• По умолчанию только чтение (read-only). Управление требует явного GEKKO_ALLOW_WRITE=true.

• Deny-List всегда остаётся закрытым: сигнализация, двери/контроль доступа и камеры остаются заблокированными даже при разрешении на запись; критические действия требуют повторного подтверждения.

• Учётные данные — только через переменные окружения, никогда не в файлах/логах (ключ в логах маскируется).

• Бережно к контроллеру: Rate-Limits и Backoff при 429/470 — иначе ошибочные запросы попадают в журнал тревог контроллера.

Подробнее: SECURITY.md.

Английское краткое руководство

MCP-сервер для контроллеров зданий myGEKKO (официальный Query API, облако или локальная сеть). По умолчанию — только чтение; запись разрешается явно (GEKKO_ALLOW_WRITE=true) и ограничена политикой (alarm/access/cameras всегда недоступны). Попробуйте его прямо на публичном демо-контроллере, используя учётные данные из первого блока выше, или установите GEKKO_USERNAME / GEKKO_KEY / GEKKO_GEKKOID для своего контроллера. Запуск через uvx --from git+https://github.com/joeexafionbot-dev/kova-mcp mygekko-mcp.

Разработка

uv sync && uv run pytest          # Tests
uv run mygekko-mcp --transport stdio
uv run dump-inventory             # read-only Inventar-Dump als JSON

Этот репозиторий — релиз-зеркало монорепозитория KOVA (там работает CI); issues и PRs здесь тоже приветствуются и синхронизируются обратно.

Лицензия и товарные знаки

См.MIT. myGEKKO — товарный знак компании myGEKKO | Ekon GmbH — KOVA MCP — это независимый community-проект и не выпускается myGEKKO. Приведённые выше демо-данные принадлежат публичному демонстрационному контроллеру myGEKKO.