iaqualink-mcp

Jandy iAqualink 풀/스파 시스템을 Claude(또는 모든 MCP 클라이언트)에 노출하는 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 .

어느 쪽이든 uvx/uv tool이 직접 실행할 수 있는 iaqualink-mcp라는 명령이 등록됩니다.

Related MCP server: Enhanced Home Assistant MCP

Claude Desktop 설정

Windows의 %APPDATA%\Claude\claude_desktop_config.json 또는 macOS의 ~/Library/Application Support/Claude/claude_desktop_config.json을 편집하고 다음을 추가합니다:

{
  "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에서 무시됩니다.

기여

이슈와 풀 리퀘스트를 환영합니다. PR을 열기 전에 pytest와 ruff check .을 실행해 주세요.

참고

• 리버스 엔지니어링된 비공식 API(iaqualink-py를 통해)를 사용합니다. Jandy/Zodiac/Fluidra는 공식 API를 제공하지 않으므로, 사용에 따른 책임은 본인에게 있습니다.

• 자격 증명은 환경 변수에서만 읽습니다. 이 서버는 디스크에 아무것도 쓰지 않습니다.

• claude_desktop_config.json에는 iAqualink 비밀번호가 평문으로 저장됩니다. 해당 파일을 커밋하거나 공유하지 말고, 컴퓨터의 다른 자격 증명 저장소처럼 취급하세요.

라이선스

MIT — LICENSE를 참조하세요.