@chrischall/iaqualink-mcp

中文文档
0.3.1发布于 2026/11/04MITES Module构建来源已验证近 30 天下载 1730

iAqualink (Zodiac/Fluidra) 为克洛德提供池式设备MCP服务器——状态外加确认加热泵,加热器,放光器,Aux和定点控制. 由AI(Claude Code)开发和维护.

中文使用文档
文档目录5 节
  1. 工具
  2. 设置
  3. 东道主(claude.ai)
  4. 技能
  5. 发展

亚克林克-mcp

MCP 服务器 iAqualink (英语) (Zodiac/Jandy/Fluidra)游泳池和温泉设备. 读取温度、定点、泵、发热器、灯光、电路和盐 氯化还原剂状态,以及切换设备——每一次更改确认 由重读校验。 它用你自己的iAqualink账户(同样的)签名 电子邮件和密码作为 iAqualink app; 没有浏览器,扩展或桥接 .

支持参考客户端支持的两个系统类型: iAqua (英语) (Jandy iAquallink小组)和 eXO 任务 (Zodiac盐氯化剂)。 其他设备 账户上的类型(robobic closers,.)列出但不受控制.

状态:部分核实为现场直播. 请求形状来自 亚克林克-平 0.7.0 (何为家) 助理使用)和一个WebTouch捕获(见 医生/IAQUALINK-API.md) (中文(简体) ).

  • 见于正版iAqua (RS) 面板工作, 2026-10-11/12: 注册 系统列表devices.json),iAqua状态为(get_home, (中文(简体) ), get_devices)和WebTouch(位置查询、init、按钮按下和 显示流).
  • 仍然产生,尚未实际行使: iAqua 水库 set_* 命令(泵, 每一份EXO请求(阴影读取和 写作, iaqualink_set_chlorinator推断出形状和 iQ20 调度 倒计时。 每篇作文仍重读以证实所出之事.

该项目由AI(Claude Code)开发和维护. 用在你的头上 自行决定.

工具

工具它会做什么注释
iaqualink_list_systems账户上的系统及其序列读取
iaqualink_get_status温度、定点、泵、加热器、指甲/灯、氯化剂、盐分/pH/ORP(view: 紧凑 . 完全 . 生)读取
iaqualink_healthcheck是否配置并接受登录读取
iaqualink_set_equipment电池/垃圾泵、电池/垃圾/溶液加热器;eXO滤波泵、生产、提速、低压、取暖——开/关写作,而非破坏性
iaqualink_set_aux打开/关闭Aux电路或光线(按编号, aux_<n> 或标签)写作,而非破坏性
iaqualink_set_light可变亮度(0/25/50/75/100)或颜色效应(iAqua)写作,而非破坏性
iaqualink_set_temperature池和/或温泉套接点(iAqua °F/°C; eXO °C池)写作,而非破坏性
iaqualink_set_chlorinatoreXO 氯化剂输出% - 假定形状, 不为 iaqualink-py写作,而非破坏性
iaqualink_list_schedules通过 WebTouch (iAqua; iQ20回落探测器) 的 RS 面板程序; eXO 计时器读取
iaqualink_add_schedule通过 WebTouch 添加 RS 面板程序( 电路、 启动、 停止、 运行天数)写作,而非破坏性
iaqualink_edit_schedule通过 WebTouch 更改 RS 面板程序的启动 / stop / 运行日写作,而非破坏性
iaqualink_delete_schedule通过 WebTouch 删除 RS 面板程序 - 无撤销写, 破坏性
iaqualink_set_schedule设置 / 重时 / 禁用 eXO 计时器( 启动 - stop, rpm 在可变速泵上) - 只有eXO,未验证的直播写作,而非破坏性
iaqualink_check_panel一个RS系统是在线的,它的面板显示什么(屏幕,打开对话框,有未保存的修改的编辑模式)? 当应用程序和这些工具有分歧时运行它读取
iaqualink_list_pump_speedsRS 面板可变速泵:通过 WebTouch 命名的速度、它们的 RPM 和运行哪个读取
iaqualink_set_pump_speed通过 WebTouch 以命名的速度运行泵写作,而非破坏性
iaqualink_set_pump_speed_rpm通过 WebTouch 更改一个命名速度的 RPM (600–3450); 设置时不会短暂运行的速度, 然后恢复运行速度写作,而非破坏性
iaqualink_list_onetouchRS 面板 OneTouch 场景(Spa Mode, All Off,...)及其状态,通过 WebTouch读取
iaqualink_set_onetouch通过 WebTouch 打开/关闭 OneTouch 场景—— 切换尚未执行的活写作,而非破坏性

系统名称. 服务器启动时列出账户的系统一次; 当它工作,每一个 serial 参数广告支持的系统' 名称(如"Pool","Spa")作为enum,每个工具接受一个名称或一个 串行——以已知系统列表拒绝未知名称. 如果 列表失败( 尚未登录, iAqualink 下行, 超过 5 s), 参数为 简单连载,别的事都改变不了 每个工具都带着 _meta.mint 提示( 域名) home· ; lookup 为读取, turn-on-off 联 合 国 set_* 开关, change mcp-host 上下文组读取 其他客户忽略.

每一作的剧本都有反演本集,没有其他的作品——除了 删除面板程序, 面板立即存储, 无倒数, 所以 一个是明显的破坏性.

Jandy Aqualink RS 面板上的时间表和 OneTouch 通过 网络触摸, 面板模拟 iAqualink 网络应用程序使用: 服务器打开 显示面板的显示流,按下一个人的相同按钮(检查 在显示面板在所期望的屏幕和行上的所有媒体前 中止否则,返回家园,并重新读取以验证。 只有一个WebTouch 每个系统每次运行一次。 添加/ 编辑/ 删除序列 在RS面板上进行现场捕捉(2026-10-11)——见 医生/IAQUALINK-API.md。 。 。 . 如果WebTouch不可用的话, iaqualink_list_schedules 返回到 iQ20 附表(适应性固件3+),探测 r-api.iaqualink.net/v2 (比尔), p-api.iaqualink.net/v2 (比尔), p-api.iaqualink.net/v2 (白令牌)和 prm.iaqualink.net/v1 每一次报告一次尝试. iQ20 时间表 写入 没有建.

写作如何. 它首先读取当前状态,如果 它已经匹配了——iAqua的泵/加热器/aux命令是 切换如此盲从 发送会翻转 不管是什么状态。 然后请您确认 (当客户端支持时, 提示提示; 否则预览加 (单位:千美元) confirmToken被捆绑在它计划对付的状态上 发送 重新读取直到请求的值显示 。 结果是 confirmed, (中文(简体) ), unchanged,或 sent-unconfirmed (eXO应用更改) 同步——再次检查而不是重试).

设置

npm i -g @chrischall/iaqualink-mcp
变量需求含义
IAQUALINK_EMAIL每个工具您的 iAqualink app 签名电子邮件
IAQUALINK_PASSWORD每个工具您的 iAqualink 密码( 不修剪)
IAQUALINK_STATUS_CACHE_SECONDS没有秒读状态被重用( 默认 5; 0 禁用)
IAQUALINK_WEBTOUCH_STREAM_HOSTS没有WebTouch 显示流可能来自额外的主机( comma- 分离) ; 仅默认 prm.iaqualink.net
IAQUALINK_VERIFY_TIMEOUT_MS没有毫秒重读以确认报告前的变化 sent-unconfirmed,对于iAqua和eXO相同(正整数;默认为 15000 iAqua, 30000 eXO)
MCP_CONFIRM_MODE没有ask-user (默认) / auto 编号 : refuse
MCP_CONFIRM_TTL_SECONDS没有确认托肯寿命( 默认600)
MCP_CONFIRM_ELICITATION没有off 即使对声明引出信息的客户也跳过提示

服务器启动时没有证书(所以主机可以列出其工具)和 第一通电话报告失踪. 一个被拒绝的密码永远不会 重审: 在服务器重新启动之前, 拒绝会被记住, 所以一个打字符 无法锁定账户.

克劳德代码 : claude mcp add iaqualink -e IAQUALINK_EMAIL=… -e IAQUALINK_PASSWORD=… -- npx -y @chrischall/iaqualink-mcp

东道主(claude.ai)

mint.yaml 使用电子邮件/密码字表的儿童申报 连接器的授权页面(每个人自己签名),向 没错 prod.zodiac-io.com, (中文(简体) ), r-api.iaqualink.net, (中文(简体) ), p-api.iaqualink.net (只有iQ20探测器)和 prm.iaqualink.net (WebTouch和iQ20探测器) WebTouch 显示流在其它主机上被拒绝, 除非添加到 IAQUALINK_WEBTOUCH_STREAM_HOSTS (而相入也. 无持久性 状态——会话活在记忆中,一个登录在感冒后重建 开始.

技能

  • skills/iaqualink 如何使用这些工具.
  • skills/iaqualink-curl - 同样的读取直接从外壳与 curl, (中文(简体) ), macOS keychain的证书(登录、系统列表和iAqua读取) ; eXO 阴影读取仍取自iaqualink-py.

发展

npm install
npm run build
npm run test:coverage   # typecheck (src + tests) + vitest, 100% coverage — what CI runs

测试将真实客户端运行于内置的 iAqualink (单位:千美元)tests/support/fake-server.ts)由iaqualink-py的固定装置所建.

版本与发布记录

@chrischall/iaqualink-mcp 共发布 8 个版本,首次发布于 2026/10/12;过去 12 个月发布了 8 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.3.1latest2026/11/045 天前
0.3.02026/11/045 天前
0.2.22026/10/1823 天前
0.2.12026/10/1624 天前
0.2.02026/10/1228 天前
0.1.02026/10/1228 天前

关于 @chrischall/iaqualink-mcp 的常见问题

@chrischall/iaqualink-mcp 是什么?

iAqualink (Zodiac/Fluidra) 为克洛德提供池式设备MCP服务器——状态外加确认加热泵,加热器,放光器,Aux和定点控制. 由AI(Claude Code)开发和维护.

如何安装 @chrischall/iaqualink-mcp?

在项目目录运行 npm install @chrischall/iaqualink-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 iaqualink-mcp,可以用 npx iaqualink-mcp 直接运行。

@chrischall/iaqualink-mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/chrischall__iaqualink-mcp 是否存在。

@chrischall/iaqualink-mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@chrischall/iaqualink-mcp 可以商用吗?

@chrischall/iaqualink-mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@chrischall/iaqualink-mcp 的下载量有多少?

根据 npm 官方下载统计,@chrischall/iaqualink-mcp 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,730 次,日均约 58 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@chrischall/iaqualink-mcp 还在维护吗?

最新版本 0.3.1 发布于 2026/11/04(5 天前);至今共发布 8 个版本,其中过去 12 个月发布了 8 个;首次发布于 2026/10/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。