ac-infinity-mcp
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
Control and monitor your AC Infinity grow environment through Claude and any MCP-compatible AI assistant.
---
What is this?
**ac-infinity-mcp** is an MCP server that connects Claude (and other AI assistants) directly to your AC Infinity controllers — so you can read live sensor data, run analytics, and adjust fan speeds or port states using natural language, without opening the AC Infinity app.
> Built with FastMCP and the AC Infinity cloud API.
Example prompts
> *"What's the VPD trend in my tent over the last 7 days?"*
> *"Is my environment in the right range for late flower?"*
> *"Turn off port 3 on my 69 Pro controller — dry run first."*
> *"Show me which ports have been running the most this week."*
> *"Apply the veg stage template to port 1 — dry run first so I can see the settings."*
> *"My VPD is too high — what should I adjust?"*
Compatible hardware
| Controller | Reads | Writes | Notes |
|---|---|---|---|
| UIS Controller 69 Pro | ✅ | ✅ | Legacy protocol |
| UIS Controller 69 Pro+ | ✅ | ✅ | Legacy protocol |
| UIS Controller 89 AI+ | ✅ | ✅ † | New AI+ protocol — port writes require the minversion header (Quirk 14) |
† Per-port writes (on/off, speed, mode, temperature/humidity/VPD automation) all work —
that is the scope of Quirk 14's minversion finding, which covers addDevMode only.
Multi-port **Advance Automations** are only partly verified on AI+: reads work, creates
and in-place edits have both landed on a devType 20 (#326), creates time out on a
different AI+ controller (#290), and enable/disable are unexercised on any AI+. Separately,
apply_grow_stage_template / break_out_of_automation are held back pending hardware
verification (#316) — both refuse with an explanation instead of writing. See
AI+ controllers.
Tools
| Category | Tool | What it does |
|---|---|---|
| 🔍 **Discovery** | discover_devices | List all your controllers and ports |
| 🌡️ **Readings** | get_device_reading | Live temp, humidity, VPD, and port states for one device |
| 🌡️ **Readings** | get_all_device_readings | Same, for all devices at once |
| 🌡️ **Readings** | get_historical_readings | Time-series data with optional bucketing (raw, 15m, 1h, 1d, …) |
| 📊 **Analytics** | check_vpd_drift | VPD target compliance check for your current grow stage |
| 📊 **Analytics** | get_environment_health | Composite health score (0–100, A–F) across temp, humidity, VPD |
| 📊 **Analytics** | detect_environment_trends | Linear trend + 7-day projection per metric |
| 📊 **Analytics** | get_port_activity_report | Per-port on/off hours, uptime %, and peak activity hour |
| 🔎 **Port Status** | get_port_status | Live port power level, load detection, active mode, and timer countdown |
| 🔎 **Port Status** | get_port_settings | Full automation config: mode, VPD target, temp/humidity thresholds, schedule, cycle |
| 🔌 **Write** | set_port_speed | Set fan or pump speed 1–10 (dry_run=True by default) |
| 🔌 **Write** | set_port_on | Turn a port fully on (dry_run=True by default) |
| 🔌 **Write** | set_port_off | Turn a port fully off (dry_run=True by default) |
| ⚙️ **Automation** | set_vpd_automation | Enable VPD mode with a kPa target using built-in sensors (dry_run=True by default) |
| ⚙️ **Automation** | set_temperature_automation | Enable AUTO mode with min/max °C thresholds (dry_run=True by default) |
| ⚙️ **Automation** | set_humidity_automation | Enable AUTO mode with min/max % RH thresholds (dry_run=True by default) |