iaiops

Vendor-neutral, governed industrial/OT data tap + intelligent troubleshooting. Read (and, gated, write) PLCs, controllers, machine tools and IIoT brokers over OPC-UA, Modbus-TCP, Siemens S7comm, Mitsubishi MC, Omron FINS, MTConnect, MQTT/Sparkplug B, Allen-Bradley EtherNet/IP, EtherCAT (pysoem/SOEM), SECS/GEM (semiconductor / display fab equipment over HSMS), PROFINET (DCP discovery), the building edition (BACnet/IP), and Phoenix Contact PLCnext vPLC — plus cross-protocol diagnostics ("no-data" dataflow diagnosis, OPC-UA connection self-diagnosis, subscription health, ISA-18.2 alarm bad-actors, tag/historian health, and the AI downtime root-cause copilot) and analytics (OEE/downtime, asset inventory, OPC-UA HDA, change-of-value). Use when the task names any industrial protocol, a PLC/SCADA/HMI/historian/CNC/RTU/IED, a semiconductor/display fab or SECS/GEM equipment, an electrical substation, an opc.tcp:// or mqtt:// endpoint, OEE/downtime, downtime root-cause, or OT asset inventory. Routes to the iaiops MCP server. Read-first; writes are MOC-gated (high risk, dry-run + double-confirm). Do NOT use for IT/network gear, Kubernetes, hypervisors, or backups — those are separate AIops tools.

iaiops — ROUTER（识别现场 → 派发 edition skill + MCP profile）

这是路由 skill，本身不含工具表。识别任务的行业/协议 → 转到对应 edition skill （工具清单、workflow、支持版本矩阵都在那边），并用对应 profile 启动 MCP（IAIOPS_MCP=<x> 环境变量，或等价 sugar 脚本 iaiops-mcp-<x>）。现场只暴露 1-2 个协议 + 跨协议脑， 单会话工具 ~15-30，模型不被淹。

路由表（关键词 → edition skill → MCP profile）

任务提到	edition skill	MCP profile / entrypoint
SECS/GEM · SECS-II · HSMS · 半导体/显示 fab · wafer · panel · MES equipment · SVID/ECID · recipe	iaiops-fab	IAIOPS_MCP=fab / iaiops-mcp-fab
离散制造产线 · PLC（S7/S7-1200/1500 · 三菱/MELSEC · Allen-Bradley/ControlLogix/CompactLogix · Omron/FINS/SYSMAC CS/CJ/CP/NX）· Modbus · EtherCAT/CoE/SOEM · PROFINET/DCP · MTConnect/CNC 机床 · Sparkplug B/UNS	iaiops-factory	IAIOPS_MCP=factory / iaiops-mcp-factory
流程工业（化工/制药/食品饮料）· HART/HART-IP · 变送器/阀门定位器 · 过程仪表 · DCS 旁路读取	iaiops-process	IAIOPS_MCP=process / iaiops-mcp-process（有 UNS 时 IAIOPS_MCP=process,sparkplug）
BACnet/BACnet-IP · HVAC/暖通 · BMS/楼宇自控 · 厂务/facility · Who-Is · TrendLog	iaiops-building	IAIOPS_MCP=building / iaiops-mcp-building
水处理/水厂 · pH · 浊度/turbidity · 电导率/conductivity · 加药/dosing · 泵站/pump station · 曝气	iaiops-water	IAIOPS_MCP=water / iaiops-mcp-water
仓储/物流中心 · 输送线/conveyor · 分拣/sorter · AGV/AMR · WMS/WCS · 托盘/穿梭车 · 物料搬运	iaiops-warehouse	IAIOPS_MCP=warehouse / iaiops-mcp-warehouse
医院设施/clinical facility · 负压/正压隔离病房 · 医用气体 · 手术室环境 · 医疗 BMS	iaiops-clinical	IAIOPS_MCP=clinical / iaiops-mcp-clinical
光伏/PV · 逆变器/inverter · 组串/string · 风电/风机 · 场站 SCADA · 新能源电站	iaiops-renewables	IAIOPS_MCP=renewables / iaiops-mcp-renewables
Phoenix Contact PLCnext / vPLC（虚拟化 PLC，走内建 OPC-UA + Modbus-TCP）	iaiops-plcnext	IAIOPS_MCP=plcnext / iaiops-mcp-plcnext
IO-Link · IO-Link master · IODD · 智能传感器/executor 参数 · pdin · ISDU（主站 JSON/REST 接口，只读）	iaiops-factory（楼宇传感器场景 iaiops-building）	IAIOPS_MCP=factory / 单协议 IAIOPS_MCP=iolink / iaiops-mcp-iolink

• 单协议深用（只有一种设备）：直接 IAIOPS_MCP=opcua（或 modbus/s7/mc/fins/eip/mtconnect/ sparkplug/ethercat/secsgem/profinet/bacnet/hart），等价脚本 iaiops-mcp-<协议>。
• 跨行业只问 OEE/停机根因/资产盘点/数据质量：任一 profile 均可 —— 跨协议脑 （诊断/OEE/资产/合规）默认随 server 暴露，选覆盖现场协议的 profile 即可； 纯脑场景可用 IAIOPS_MCP=brain / iaiops-mcp-brain（只暴露脑，零协议）。
• 说不清行业但报了协议名：按协议列选含它的最小 profile；都不沾 → iaiops doctor + protocols_supported 先看现场配置了什么。

部署（0.10.0 起：无默认，必须选菜单）

• 裸启动 iaiops-mcp（不设 IAIOPS_MCP）不再暴露全部工具：打印选择菜单到 stderr 并 exit 2。必须设 IAIOPS_MCP=<selection> 或用预置入口 iaiops-mcp-<name>。 IAIOPS_MCP=menu 显式打印同一菜单（带各 selection 工具数）后退出。
• IAIOPS_MCP=all 仍可显式使用（power user；>100 工具时启动日志给洪泛警告）。
• 多进程站点（1 脑 + N 协议）：跑一个 iaiops-mcp-brain（只脑），协议 server 各自 加 IAIOPS_MCP_NO_BRAIN=1（如 IAIOPS_MCP_NO_BRAIN=1 iaiops-mcp-opcua）去掉脑， 避免跨 server 工具重名；protocols_supported（发现工具）在 NO_BRAIN 下仍然保留。

Energy 协议 → 另一个包（不在本 server）

IEC 60870-5-104 / IEC-104、DNP3 / outstation、IEC 61850 / MMS / IED、变电站/ substation、电力/能源/utility SCADA → 用独立的 iaiops-energy （pip install iaiops-energy，然后 iaiops-energy-mcp； github.com/industrial-aiops/industrial-aiops-energy）。它复用本包的 core + 脑； monitor-direction only。不要尝试用本 server 的 profile 覆盖能源协议。

安全不变量（所有 edition 一致，路由前先记住）

• Read-first：默认只读；先 protocols_supported 看能力、iaiops doctor / <protocol> doctor 验链路，再谈读，最后才谈写。
• 写 = MOC（Management-of-Change）：The 10 write tools（s7_write_db、 mc_write_words、fins_write_words、mqtt_publish、eip_write_tag、ethercat_write_sdo、 ethercat_set_state、profinet_dcp_set、bacnet_write_property、bas_command）全部 risk=HIGH、默认 dry_run=True、捕获改前值供 undo（bas_command 另对生命安全点一律拒绝）。 这 10 个是设备写。写历史库/时序库那类不改变现场状态的写另计， 由 edition skill 逐个列明 —— 别把「10」当成全部写面。
• 审批：真实写入需具名审批人 —— CLI iaiops approve 双重确认后才放行。
• 未经授权绝不写生产控制系统；AI 结论仅 advisory，引用真实信号出处，宁可 insufficient_evidence 不臆测。
• 各协议的验证状态（✅ 已自测 / 待核实）见 edition skill 的支持版本矩阵， 标 待核实 的不得当既成事实。

先回答「这个站能干什么」，再谈干（0.24.0）

路由到 edition 之前，这两条不分行业、任何现场都先跑，而且零联网：

• iaiops readiness ——「这个站点今天能跑哪些场景、每个缺口还差什么」， 按「补上它能解锁多少」排序。它只报告，绝不代填。
• iaiops investigate plan ——「真出事时能走到那八步里的第几步」。缺口分两种，别混： 你还没供（会直接给出该跑的命令）与 产品供不了（标 not_yet_expressible）。 这两个把人送去完全不同的地方。

对一个已经过去的窗口逐步走完并留档：iaiops investigate open|show|list。 不碰设备 —— 窗口已经过去，证据就是当时采到的。三条都能 --report x.html 出可转发的自包含文件。

两步需要人先声明，agent 不许代答：

• iaiops relations declare —— 产线上下游。D25：线上下游共现是必然， 从时间推不出因果，所以只能声明。
• iaiops knowledge mount —— ISO 14224 故障机理库，可排除、绝不确认； 库里没有这条原因返回 nothing_known，那不是「无异议」。

点表语义（role:）只能人给 —— 哪个位号是产量计数器是工艺知识，猜错会得出一个 看着合理的 OEE，比报错更糟（D16）。输入口是 iaiops tags export|apply|page： 导出的 role 列是空的，哪怕紧挨着一个叫 GoodPartsCounter 的位号。 这一层故意没有 MCP 工具 —— 让 agent 填 role 列正是 D16 禁止的那个猜测。 遇到它，把表交给现场的人，不要自己填。

以上除 tags 外都是双前端：CLI 与 MCP 同一个引擎。对应的 MCP 工具名由 edition skill 列明（本 skill 是路由，不带工具表）。

Setup（各 edition 相同）

iaiops init 交互写 ~/.iaiops/config.yaml；凭据进加密存储 （~/.iaiops/secrets.enc，主密码 IAIOPS_MASTER_PASSWORD）。iaiops doctor 逐端点探活。协议参数、模拟器自测、MCP JSON 示例见 README 与各 edition skill。