iaqualink-mcp

一个 MCP 服务器，可将 Jandy iAqualink 泳池/水疗池系统开放给 Claude（或任何 MCP 客户端）。它封装了 iaqualink Python 库。

提供的工具：

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

如果你只希望 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 已被 git 忽略。

参与贡献

欢迎提交 Issue 和拉取请求。请在发起 PR 前运行 pytest 和 ruff check .。

备注

• 这使用了逆向工程得到的非官方 API（通过 iaqualink-py）；Jandy/Zodiac/Fluidra 没有发布官方 API。使用风险自负。

• 凭据仅从环境变量读取——本服务器不会向磁盘写入任何数据。

• 你的 claude_desktop_config.json 中会以明文形式包含 iAqualink 密码。不要提交或分享该文件，并像对待机器上其他凭据存储一样保护它。

许可证

MIT — 参见 LICENSE。