--- slug: "iaiops-x" source_type: "clawhub" source_url: "https://clawhub.ai/skills/iaiops" repo: "" source_file: "description" --- --- name: iaiops description: >- 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=` 环境变量，或等价 sugar 脚本 `iaiops-mcp-`）。现场只暴露 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=` 或用预置入口 `iaiops-mcp-`。 `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` / ` 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` 另对生命安全点一律拒绝）。 - **审批**：真实写入需具名审批人 —— CLI `iaiops approve` 双重确认后才放行。 - **未经授权绝不写生产控制系统**；AI 结论仅 advisory，引用真实信号出处，宁可 `insufficient_evidence` 不臆测。 - 各协议的验证状态（✅ 已自测 / 待核实）见 edition skill 的支持版本矩阵， 标 `待核实` 的不得当既成事实。 ## Setup（各 edition 相同） `iaiops init` 交互写 `~/.iaiops/config.yaml`；凭据进加密存储 （`~/.iaiops/secrets.enc`，主密码 `IAIOPS_MASTER_PASSWORD`）。`iaiops doctor` 逐端点探活。协议参数、模拟器自测、MCP JSON 示例见 README 与各 edition skill。