KOVA MCP

あなたのmyGEKKOと話そう。 Claude（および他のMCPクライアント）をmyGEKKOビルディングコントローラーに接続するオープンソースのMCPサーバー — 公式のmyGEKKO Query API経由。ClaudeからmyGEKKOビルディングコントローラーに話しかけよう — 英語クイックスタートは下記。

「リビングは何度？」「まだ点いている照明は？」「南側のブラインドを下ろして。」— あなたの言葉で、直接あなたの家へ。

KOVA MCPは、ホビイストやパワーユーザーのためのツールです。 毎日、スマホで、家族全員のために使いたい人 — ターミナルなしで：それがKOVAアプリ（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が必要です。

• 拒否リストは常に有効： 警報装置、ドア/入退室、カメラは書き込み許可があってもロックされています。重要な操作には2回目の確認が必要です。

• 認証情報は環境変数のみ、ファイルやログには決して保存しません（キーはログでマスクされます）。

• コントローラーに優しい： 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/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はそちらで実行）。それでもIssueやPRはここで歓迎され、反映されます。

ライセンスと商標

MIT。myGEKKOはmyGEKKO | Ekon GmbHの商標です — KOVA MCPは独立したコミュニティプロジェクトであり、myGEKKOが発行しているものではありません。上記のデモ認証情報はmyGEKKOの公開デモコントローラー用です。