KOVA MCP

与你的 myGEKKO 对话。 一个开源 MCP 服务器，将 Claude（以及任何其他 MCP 客户端）与 myGEKKO 楼宇控制器连接起来 — 通过官方 myGEKKO Query API。从 Claude 与你的 myGEKKO 楼宇控制器对话 — 英语快速入门见下文。

„客厅里有多暖和？" · „还有哪些灯亮着？" · „把南边的百叶窗放下来。" — 用你自己的话，直接传达给你的房子。

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。

服务器能做什么

安全性（刻意保守）

• 默认只读。 控制需要显式设置 GEKKO_ALLOW_WRITE=true。

• 拒绝列表始终生效： 即使允许写入，报警系统、门/访问控制、摄像头仍被锁定；关键操作需要二次确认。

• 凭据仅通过环境变量传递，绝不写入文件或日志（密钥在日志中会被遮蔽）。

• 对控制器友好： 在 429/470 时进行速率限制和退避 — 否则错误请求会进入控制器的报警日志。

详情：SECURITY.md。

英语快速入门

myGEKKO 楼宇控制器的 MCP 服务器（官方 Query API，云端或 LAN）。默认只读；写入需显式选择（GEKKO_ALLOW_WRITE=true）并受策略限制（报警/访问/摄像头始终拒绝）。使用上面第一个片段中的凭据即可立即试用公共演示控制器，或为你的控制器设置 GEKKO_USERNAME / GEKKO_KEY / GEKKO_GEKKOID。通过 uvx --from git+https://github.com/joevafionbot-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 在那里运行）；问题和 PR 在这里同样欢迎，并会被回传。

许可证与商标

MIT。myGEKKO 是 myGEKKO | Ekon GmbH 的商标 — KOVA MCP 是一个独立的社区项目，并非由 myGEKKO 发布。上面的演示凭据属于 myGEKKO 的公共演示控制器。