Skip to main content
Glama
iaqualink-mcp

iaqualink-mcp

by jgonzalez007

iaqualink-mcp

CI License: MIT

一个 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: Home Assistant MCP Server

配置 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。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to control Bond Bridge smart home devices including ceiling fans, motorized shades, dimmable lights, and other RF-controlled devices. Provides comprehensive device management and control capabilities through the Bond Local API.
      10
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Home Assistant smart home devices through natural language. Control devices, manage automations, query entity states, and retrieve historical data across your home automation system.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to control Govee smart devices, including lights, via natural language. Supports turning on/off, changing colors, adjusting brightness, and activating scenes through the Govee API or local network.
      9
      1
      MIT