iaqualink-mcp

MCP-сервер, который предоставляет Claude (или любому MCP-клиенту) доступ к системе бассейна/спа Jandy iAqualink. Он оборачивает Python-библиотеку iaqualink.

Предоставляемые инструменты:

• list_systems — все системы в учётной записи

• list_devices — все устройства системы

• get_device — состояние одного устройства

• get_system_status — состояние системы и всех устройств одним вызовом

• 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 .

В любом случае регистрируется команда iaqualink-mcp, которую uvx/uv tool может запускать напрямую.

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"
      }
    }
  }
}

Добавьте "IAQUALINK_READ_ONLY": "true" в env, если вы хотите, чтобы Claude только читал статус и никогда не управлял оборудованием.

Затем полностью выйдите из 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 игнорируется Git.

Вклад в проект

Issues и pull requests приветствуются. Пожалуйста, запустите pytest и ruff check . перед открытием PR.

Примечания

• Используется реконструированный/неофициальный API (через iaqualink-py); компания Jandy/ Zodiac/Fluidra не публикует официального API. Пользуйтесь на свой страх и риск.

• Учётные данные считываются только из переменных окружения — этот сервер ничего не записывает на диск.

• Ваш claude_desktop_config.json будет содержать пароль iAqualink в открытом виде. Не коммитьте этот файл и не передавать его я вам, и относитесь к нему как к любому другому хранилищу учётных данных на вашем компьютере.

Лицензия

MIT — см. LICENSE.