iaqualink-mcp

Jandy iAqualink のプール/スパシステムを Claude（または任意のMCPクライアント）に公開するMCPサーバーです。iaqualink Python ライブラリをラップしています。

提供されるツール:

• list_systems — アカウント上のすべてのシステム

• list_devices — システム上のすべてのデバイス

• get_device — 1 つのデバイスの状態

• get_system_status — システムと全デバイスの状態を 1 回の呼び出しで取得

• turn_on / turn_off / toggle_device

• set_temperature — サーモスタットの設定温度

• set_light_effect / set_light_rgbw / set_light_brightness — ICL/IntelliCenter ライト

IAQUALINK_READ_ONLY=true を設定すると、すべての書き込みツールが無効化され、読み取りのみが許可されます。

インストール

GitHub から（プッシュ後）

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

ローカルクローンから（開発におすすめ。uvx が起動のたびにプロジェクトをクローン/ビルドする手間が省けます）

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

どちらの方法でも、uvx/uv tool が直接実行できる iaqualink-mcp というコマンドが登録されます。

Related MCP server: Enhanced Home Assistant MCP

Claude Desktop の設定

%APPDATA%\Claude\claude_desktop_config.json（Windows）または ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）を編集して、以下を追加してください:

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

Claude に状態を読み取らせるだけで、機器を制御させたくない場合は、env に "IAQUALINK_READ_ONLY": "true" を追加してください。

そのうえで、システムトレイから Claude Desktop を完全に終了し（ウィンドウを閉じるだけでは不十分です）、再起動してください。

開発

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

# Run tests
uv run pytest

# Lint
uvx ruff check .

ローカルでの手動テストのために .env.example を .env にコピーし、認証情報を入力してください。.env は gitignore されています。

コントリビューション

Issue とプルリクエストは歓迎します。PR を開く前に pytest と ruff check . を実行してください。

注意事項

• これはリバースエンジニアリングされた非公式 API（iaqualink-py 経由）を使用しています。Jandy/Zodiac/Fluidra は公式 API を公開していません。利用は自己責任でお願いします。

• 認証情報は環境変数のみから読み取られ、このサーバーがディスクに書き込むことはありません。

• claude_desktop_config.json には iAqualink のパスワードが平文で含まれます。そのファイルをコミットしたり共有したりせず、お使いのマシン上の他の認証情報ストアと同じように扱ってください。

ライセンス

MIT — LICENSE を参照してください。