iaqualink-mcp
iaqualink-mcp
Jandy iAqualink 풀/스파 시스템을 Claude(또는 모든 MCP 클라이언트)에 노출하는 MCP 서버입니다. iaqualink Python 라이브러리를 래핑합니다.
제공되는 도구:
list_systems— 계정의 모든 시스템 조회list_devices— 시스템의 모든 장치 조회get_device— 단일 장치의 상태 조회get_system_status— 시스템과 모든 장치의 상태를 한 번의 호출로 조회turn_on/turn_off/toggle_deviceset_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
Control your Tesla from your AI assistant - climate, charging, access, and security.
Control your existing Philips lights, Sonos speakers, Roborock vacuums and other supported devices through Port OS cloud. Give ChatGPT, Claude and other MCP-compatible assistants access to the devices you connect. Turn off the living room lights, play music on your speakers, adjust the thermostat, run a vacuum in a room, check a camera snapshot or find a connected tracker. Available actions depend on your linked provider accounts and each device’s supported capabilities. Port OS runs in the cloud; no local server is required. You choose the account, device and capability permissions each assistant receives. Device operations require user OAuth; public tool discovery does not grant device access. Port OS is in alpha. Setup: https://portoperatingsystem.com/docs/getting-started/ Support: https://portoperatingsystem.com/contact/
Home energy for AI assistants: live Power flow, Energy history, solar forecast, and device control.
Manage digital signage screens, playlists and media from your AI assistant.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables 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.10MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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.1MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to control Tuya/Smart Life smart home devices via tools like on/off, brightness, color, and custom commands.1077 PyPI1MIT
- AlicenseAqualityDmaintenanceEnables 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.91MIT