rachio-mcp

できること

Rachio の散水システムを、あらゆる MCP クライアント（Claude Code、Claude Desktop など）から使えるようにします。「今、何か散水していますか？」、「前庭の芝を10分間散水して」、「2日間のレインデレイに設定して」 というように、自然言語で指示できます。

Rachio public API を使用しています。クラウド型・トークンベースで、どこからでも動作します（コントローラーと同じネットワークにいる必要はありません）。

Related MCP server: opensprinkler-mcp

ツール

ゾーンとデバイスは、API の ID だけでなく、名前または番号でも指定できます。

要件

• Python 3.12+

• uv

• Rachio アカウントと API トークン

API トークンを取得する

Rachio モバイルアプリで: Profile → Get API Key → Copy。 これはアカウントに紐づく単一のベアラトークンです。パスワードと同等に扱ってください。

インストール

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 に設定します。

• ローカル / オープンソースモデル — Ollama、Llama、Qwen などを実行している MCP 対応クライアント（Cline、Continue、LibreChat、Open WebUI、Goose、Zed、Cursor）経由で利用できます。

• その他の 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. の商標です。