KOVA MCP

내 myGEKKO와 대화하세요. 오픈소스 MCP 서버로, Claude(및 다른 모든 MCP 클라이언트)를 myGEKKO 건물 제어기와 연결합니다 — 공식 myGEKKO Query API를 통해. Talk to your myGEKKO building controller from Claude — English quickstart below.

"거실 온도는 얼마나 되나요?" · "아직 켜져 있는 조명은 무엇인가요?" · "남쪽의 블라인드를 내려줘." — 당신의 말로, 집에 직접 전달됩니다.

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에 등록되어 있고 플러스 서비스 **"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/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는 거기서 실행됨); 여기서 이슈와 PR도 환영하며 반영됩니다.

라이선스 및 상표

MIT. myGEKKO는 myGEKKO | Ekon GmbH의 상표입니다 — KOVA MCP는 독립적인 커뮤니티 프로젝트이며 myGEKKO가 발행하지 않습니다. 위의 데모 자격 증명은 myGEKKO의 공개 데모 제어기에 속합니다.