Skip to main content
Glama
iaqualink-mcp

iaqualink-mcp

by jgonzalez007

iaqualink-mcp

CI License: MIT

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

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를 참조하세요.

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