rachio-mcp

Что делает

Предоставляет вашу систему полива Rachio любому MCP-клиенту (Claude Code, Claude Desktop и т.д.), чтобы вы могли спросить «сейчас что-то поливается?», «полей передний газон 10 минут» или «поставь задержку дождя на 2 дня» на естественном языке.

Использует публичное API Rachio — облачное, на основе токена, работает откуда угодно (не нужно находиться в одной сети с контроллером).

Related MCP server: opensprinkler-mcp

Инструменты

Зоны и устройства можно указывать по имени или номеру, а не только по их API-идентификаторам.

Требования

• Python 3.12+

• uv

• Аккаунт Rachio и API-токен

Получите свой API-токен

В мобильном приложении Rachio: Profile → Get API Key → Copy. Это единый bearer-токен, привязанный к вашему аккаунту — относитесь к нему как к паролю.

Установка

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 в окружении.

• Локальные / open-source модели — через любой MCP-совместимый клиент (Cline, Continue, LibreChat, Open WebUI, Goose, Zed, Cursor), работающий с Ollama, Llama, Qwen и т.д.

• Любой другой MCP-клиент — та же stdio-команда, что и в примерах для Claude выше.

Единственное требование — модель, способная к вызову инструментов/функций; крупные размещённые модели и более сильные локальные (Llama 3.1+, Qwen 2.5+) отлично с этим справляются.

Примечания

• Несколько контроллеров: каждый инструмент принимает необязательный аргумент device (имя или id), обязательный только если в аккаунте больше одного контроллера.

• Длительность: запуск зон ограничен 180 минутами, а задержка дождя — 7 днями, в соответствии с лимитами API.

• Режим ожидания: set_device_power(on=false) переводит контроллер в режим ожидания, приостанавливая весь запланированный полив до повторного включения.

• Лимиты запросов: API Rachio допускает 1700 вызовов в день на токен; все эти инструменты — одиночные вызовы, так что при обычном использовании вы далеки от лимита.

Как это устроено

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

Лицензия

MIT. Не аффилировано с Rachio, Inc. и не одобрено ею. «Rachio» — товарный знак Rachio, Inc.