KOVA MCP

Habla con tu myGEKKO. Un servidor MCP de código abierto que conecta a Claude (y a cualquier otro cliente MCP) con los controladores de edificios myGEKKO — a través de la API oficial myGEKKO Query. Habla con tu controlador de edificios myGEKKO desde Claude — guía rápida en inglés a continuación.

„¿Qué temperatura hace en el salón?" · „¿Qué luces están encendidas?" · „Baja las persianas del sur." — en tus palabras, directo a tu casa.

KOVA MCP es la herramienta para aficionados y usuarios avanzados. ¿Lo usas a diario, desde el móvil y para toda la familia? Entonces prueba la app KOVA (gekkobrain.beikoma.com).

Pruébalo en 2 minutos — sin controlador propio

El controlador de demostración público de myGEKKO („Mustermann") está disponible para estas pruebas:

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

Luego en Claude: „¿Qué sistemas hay en mi edificio? Muéstrame las luces del salón."

Con tu propio myGEKKO

Requisito: tener un controlador registrado en my-gekko.com y el servicio de pago „myGEKKO Query API" activado (incluido en el paquete Home; genera la clave en Ajustes → Globo → Plus Avanzado → Query API → Nuevo → Generar).

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"
      }
    }
  }
}

También local (LAN en lugar de nube) es posible: GEKKO_MODE=local + GEKKO_LOCAL_HOST — todas las variables están en .env.example.

Qué puede hacer el servidor

Seguridad (deliberadamente conservadora)

• Solo lectura por defecto. El control requiere activar explícitamente GEKKO_ALLOW_WRITE=true.

• La lista de denegados siempre permanece activa: alarma, puertas/acceso, cámaras están bloqueadas incluso con permiso de escritura; las acciones críticas requieren una segunda confirmación.

• Credenciales solo mediante variables de entorno, nunca en archivos o registros (la clave se enmascara en los registros).

• Respetuoso con el controlador: límites de velocidad y espera con retroceso en 429/470 — las solicitudes erróneas acaban en el registro de alarmas del controlador.

Detalles: SECURITY.md.

Guía rápida en inglés

MCP server for myGEKKO building controllers (official Query API, cloud or local). Read-only by default; writes are opt-in (GEKKO_ALLOW_WRITE=true) and policy-gated (alarm/access/cameras always denied). Try it instantly against the public demo controller using the credentials in the first snippet above, or set GEKKO_USERNAME / GEKKO_KEY / GEKKO_GEKKOID for your own controller. Run via uv --from git+https://github.com/joe-exonbot-dev/kova-mcp mygekko-mcp.

Desarrollo

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

Este repositorio es el espejo de publicación del monorepo de KOVA (allí se ejecuta la CI); las issues y PRs son bienvenidas aquí y se reenvían.

Licencia y marcas

MIT. myGEKKO es una marca de myGEKKO | Ekon GmbH — KOVA MCP es un proyecto comunitario independiente y no está respaldado por myGEKKO. Los datos de acceso de demostración anteriores pertenecen al controlador de demostración público de myGEKKO.