rachio-mcp

기능

Rachio 관개 시스템을 모든 MCP 클라이언트(Claude Code, Claude Desktop 등)에 노출하여 "지금 물을 주는 중인가요?", "앞마당에 10분만 물을 줘", "2일간 비 연기로 설정해 줘" 같은 질문을 자연어로 할 수 있습니다.

Rachio 공개 API를 사용합니다 — 클라우드 기반, 토큰 인증 방식으로 어디서든 동작합니다(컨트롤러와 같은 네트워크에 있을 필요 없음).

Related MCP server: opensprinkler-mcp

도구

구역과 장치는 API ID뿐만 아니라 이름 또는 번호로도 참조할 수 있습니다.

요구 사항

• Python 3.12+

• uv

• Rachio 계정 및 API 토큰

API 토큰 받기

Rachio 모바일 앱에서: 프로필 → API 키 가져오기 → 복사. 계정에 연결된 단일 베어러 토큰입니다 — 비밀번호처럼 취급하세요.

설치

git clone https://github.com/rudy325/rachio-mcp.git
cd rachio-mcp
uv sync

설정

export RACHIO_API_TOKEN=your-api-token

.env.example을 참조하세요.

Claude Code에 등록

claude mcp add rachio \
  --env RACHIO_API_TOKEN=your-api-token \
  -- uv --directory /path/to/rachio-mcp run server.py

또는 Claude Desktop에서 claude_desktop_config.json에:

{
  "mcpServers": {
    "rachio": {
      "command": "uv",
      "args": ["--directory", "/path/to/rachio-mcp", "run", "server.py"],
      "env": { "RACHIO_API_TOKEN": "your-api-token" }
    }
  }
}

다른 클라이언트와 함께 사용 (OpenAI, 로컬 모델 등)

이것은 표준 MCP 서버입니다 — stdio를 통해 공개 프로토콜을 사용하며 어떤 모델이나 클라이언트가 구동하는지 상관하지 않습니다. MCP를 지원하는 모든 것이 동작합니다:

• OpenAI — Agents SDK 및 Responses API는 MCP 서버를 지원합니다. 다음을 가리키세요: command: "uv", args: ["--directory", "/path/to/rachio-mcp", "run", "server.py"], 환경에 RACHIO_API_TOKEN 포함.

• 로컬 / 오픈소스 모델 — MCP를 지원하는 모든 클라이언트(Cline, Continue, LibreChat, Open WebUI, Goose, Zed, Cursor)에서 Ollama, Llama, Qwen 등을 실행.

• 기타 모든 MCP 클라이언트 — 위 Claude 예시와 동일한 stdio 명령.

유일한 요구 사항은 도구/함수 호출에 능숙한 모델입니다; 대형 호스팅 모델과 강력한 로컬 모델(Llama 3.1+, Qwen 2.5+)은 잘 처리합니다.

참고 사항

• 여러 컨트롤러: 모든 도구는 선택적 device 인자(이름 또는 ID)를 받으며, 계정에 컨트롤러가 여러 개일 때만 필요합니다.

• 기간: 구역 실행은 180분, 비중기는 7일로 제한되며 API 한도와 일치합니다.

• 대기 모드: set_device_power(on=false)는 컨트롤러를 대기 모드로 전환하여 다시 켤 때까지 모든 예약 물주기를 일시 중지합니다.

• 속도 제한: Rachio API는 토큰당 하루 1700회 호출을 허용합니다; 이 도구들은 모두 단일 호출이므로 일반적인 사용은 한도에 근접하지 않습니다.

구성 방식

MCP client ──stdio──> server.py ──HTTPS──> api.rach.io/1 ──> your Rachio controller

라이선스

MIT. Rachio, Inc.와 제휴하거나 보증하지 않습니다. "Rachio"는 Rachio, Inc.의 상표입니다.