用途
ac-infinity-mcp 是一个 MCP（Model Context Protocol）服务器，用于将 AC Infinity 种植控制器接入 Claude 及其他兼容 MCP 的 AI 助手。它让用户通过自然语言完成气候监控、端口控制和种植自动化，而不必打开 AC Infinity 官方应用。项目基于 FastMCP 与 AC Infinity 云 API 构建。
主要能力
- 读取实时传感器数据，并查看历史数据与趋势分析。
- 查询 VPD、温度、湿度等环境指标，判断是否处于特定生长阶段（如 late flower）的合适范围。
- 控制端口状态与风扇转速，支持按端口写入开关、速度、模式以及温度/湿度/VPD 自动化。
- 提供示例提示词，例如查询过去 7 天帐篷内 VPD 趋势、关闭 69 Pro 控制器上的 3 号端口（先 dry run）、查看本周运行最多的端口、对 1 号端口应用 veg 阶段模板（先 dry run）、以及 VPD 过高时询问应调整什么。
- 内置三个提示词，在 Claude Desktop 等 MCP 客户端中会以斜杠命令或提示建议的形式出现。
使用方式
安装方式有三种：
- 方式一：pip（最简单），要求 Python 3.11+。
- 方式二：隔离 venv（推荐）。
- 方式三：uvx（无需安装）。
MCP 客户端配置：编辑 macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %APPDATA%\Claude\claude_desktop_config.json，将 /path/to/ac-infinity-mcp 替换为 which ac-infinity-mcp 输出的路径。Cursor / Windsurf 则在 MCP 设置中添加配置。容器通过 stdio 运行，可借助 mcp-proxy 等 stdio 桥接连接；凭据在运行时通过 env_file 注入，不会烘焙进镜像。
所有写入工具（Write、Automation 和 Intelligence 类别）默认 dry_run=True，只返回将要发送的精确载荷而不改动设备；仅在准备执行时传入 dry_run=False。
适用场景
适合使用 AC Infinity 控制器进行种植环境管理的用户，希望通过 AI 助手以对话方式监控气候、分析历史数据、调整风扇与端口，并执行种植阶段自动化。
限制与注意事项
- 上游 AC Infinity 云 API 仅支持 HTTP，不支持 HTTPS，凭据和传感器数据以明文在网络中传输，这是上游限制；应避免在不受信任的网络上运行此服务器。
- 兼容硬件方面：按端口写入（开关、速度、模式、温度/湿度/VPD 自动化）均可工作；多端口 Advance Automations 在 AI+ 上仅部分验证——读取可用，创建和就地编辑在 devType 20 上均已落地，但在另一台 AI+ 控制器上创建会超时，启用/禁用在任何 AI+ 上均未测试。
apply_grow_stage_template/break_out_of_automation因等待硬件验证而被暂缓，两者会拒绝执行并给出说明，而不是写入。- 漏洞应通过 GitHub Private Vulnerability Reporting 报告；完整披露政策、范围和已知限制见 SECURITY.md，已接受的依赖 CVE 记录在 docs/SECURITY-RISKS.md。
- 完整种植者指南（含每个工具的对话示例）见 docs/GUIDE.md。
