# @chrischall/iaqualink-mcp 中文文档

规范地址：https://npmcn.com/package/%40chrischall/iaqualink-mcp/

版本：0\.3\.1
npm 元数据更新时间：2026-11-04T11:51:43.801Z
中文译文更新时间：2026-11-09T21:08:18.181Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40chrischall/iaqualink-mcp
原文对照：https://npmcn.com/package/%40chrischall/iaqualink-mcp/?lang=original
项目主页：https://github.com/chrischall/iaqualink-mcp#readme
源码仓库：https://github.com/chrischall/iaqualink-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.8 MB，31 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：4 个
- 首次发布：2026-10-12T02:46:18.576Z
- 最新版本发布：2026-11-04T11:51:43.481Z
- 近 30 天下载量：1730（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

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

## 安装

```sh
npm install @chrischall/iaqualink-mcp
```

也可以使用：`pnpm add @chrischall/iaqualink-mcp`、`yarn add @chrischall/iaqualink-mcp`、`bun add @chrischall/iaqualink-mcp`

## README

# 亚克林克-mcp

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

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

> **状态:部分核实为现场直播.** 请求形状来自 [亚克林克-平](https://pypi.org/project/iaqualink/) 0.7.0 (何为家) 助理使用)和一个WebTouch捕获(见 [医生/IAQUALINK-API.md](https://npmcn.com/package/%40chrischall/iaqualink-mcp/docs/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_chlorinator` | eXO 氯化剂输出% - **假定形状, 不为 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_speeds` | RS 面板可变速泵:通过 WebTouch 命名的速度、它们的 RPM 和运行哪个 | 读取 |
| `iaqualink_set_pump_speed` | 通过 WebTouch 以命名的速度运行泵 | 写作,而非破坏性 |
| `iaqualink_set_pump_speed_rpm` | 通过 WebTouch 更改一个命名速度的 RPM (600–3450); 设置时不会短暂运行的速度, 然后恢复运行速度 | 写作,而非破坏性 |
| `iaqualink_list_onetouch` | RS 面板 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](https://npmcn.com/package/%40chrischall/iaqualink-mcp/docs/IAQUALINK-API.md#webtouch-aqualink-rs-panel-emulation)。 。 。 . 如果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应用更改) 同步——再次检查而不是重试).

## 设置

```sh
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.

## 发展

```sh
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 是什么？

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 和提交记录判断。