iaqualink-mcp

Ein MCP-Server, der ein Jandy-iAqualink-Pool-/Spa-System für Claude (oder jeden MCP-Client) bereitstellt. Er kapselt die Python-Bibliothek iaqualink.

Bereitgestellte Tools:

• list_systems — alle Systeme des Kontos

• list_devices — alle Geräte eines Systems

• get_device — Status eines Geräts

• get_system_status — Systemstatus und Status jedes Geräts in einem Aufruf

• turn_on / turn_off / toggle_device

• set_temperature — Thermostat-Sollwerte

• set_light_effect / set_light_rgbw / set_light_brightness — ICL/IntelliCenter-Lichter

Setzen Sie IAQUALINK_READ_ONLY=true, um sämtliche Schreibwerkzeuge zu deaktivieren und nur Lesezugriffe zu erlauben.

Installation

Von GitHub (sobald gepusht)

uv tool install git+https://github.com/yourusername/iaqualink-mcp

Aus einem lokalen Klon (für die Entwicklung empfohlen und vermeidet, dass uvx das Projekt bei jedem Start klonen/bauen muss)

git clone https://github.com/yourusername/iaqualink-mcp
cd iaqualink-mcp
uv tool install .

In jedem Fall wird dadurch ein Befehl namens iaqualink-mcp registriert, den uvx/uv tool direkt ausführen kann.

Related MCP server: Enhanced Home Assistant MCP

Claude Desktop konfigurieren

Bearbeiten Sie %APPDATA%\Claude\claude_desktop_config.json (Windows) oder ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) und fügen Sie Folgendes hinzu:

{
  "mcpServers": {
    "iaqualink": {
      "command": "uvx",
      "args": ["iaqualink-mcp"],
      "env": {
        "IAQUALINK_USERNAME": "you@example.com",
        "IAQUALINK_PASSWORD": "your-iaqualink-password"
      }
    }
  }
}

Fügen Sie "IAQUALINK_READ_ONLY": "true" zu env hinzu, wenn Claude nur den Status lesen und niemals Geräte steuern soll.

Beenden Sie Claude Desktop anschließend vollständig über das System-Tray (nicht nur das Fenster schließen) und starten Sie es erneut.

Entwicklung

git clone https://github.com/yourusername/iaqualink-mcp
cd iaqualink-mcp
uv sync --extra dev

# Run tests
uv run pytest

# Lint
uvx ruff check .

Kopieren Sie .env.example nach .env und tragen Sie Ihre Zugangsdaten für lokale manuelle Tests ein; .env ist gitignored.

Mitwirken

Issues und Pull Requests sind willkommen. Bitte führen Sie pytest und ruff check . aus, bevor Sie einen PR eröffnen.

Hinweise

• Dieser Server verwendet eine durch Reverse Engineering gewonnene/inoffizielle API (über iaqualink-py); Jandy/Zodiac/Fluidra veröffentlichen keine offizielle API. Nutzung auf eigenes Risiko.

• Zugangsdaten werden ausschließlich aus Umgebungsvariablen gelesen – dieser Server schreibt nichts auf die Festplatte.

• Ihre claude_desktop_config.json wird Ihr iAqualink-Passwort im Klartext enthalten. Committen Sie diese Datei nicht und geben Sie sie nicht weiter; behandeln Sie sie wie jeden anderen Anmeldedaten-Speicher auf Ihrem Rechner.

Lizenz

MIT – siehe LICENSE.