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 移动应用 中：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。

• 本地 / 开源模型 — 通过任何支持 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. 的商标。