站点与资产 — 按行业划分的站点(电力/燃气/水/可再生能源);资产具有运行状态(运行中/停用/锁定/故障)及锁定标签。
它为代理提供什么
一个专门为单个 MCP 连接设计的能力。
服务器拥有其领域逻辑,并发布 MCP 客户端可发现的工具契约。ADK-Rust 可将该契约加载到代理中,为所选模型提供者规范每个模式,并将连接生命周期保持在代理业务逻辑之外。
标签 / 点 — 可寻址的遥测和控制点,类型为模拟/状态(只读)或设定点/控制(可写),带有工程范围和警告/严重阈值。
遥测与历史记录 — ingest_reading记录历史并自动触发/清除阈值报警;tag_history和tag_trend用于分析。
报警 — 活动 → 确认 → 清除的生命周期,按严重性分类。
控制 — issue_command执行联锁链,且仅在全部通过时应用值;check_interlocks为只读的模拟运行。
停电 — report_outage自动分级优先级(P1最高);outage_queue为按优先级排序的工作队列。
维护 — 工作订单(预防性/纠正性/检查/紧急)含调度与分配。
架构
SCADA MCP Server 在代理系统中的作用。
模型无需了解服务器背后系统的实现细节或凭证。它看到审核过的工具定义。MCP 客户端负责发现和调用,服务器保持验证、策略和与领域系统的通信所有权。
ADK-Rust 代理
从审核过的工具目录中选择能力。
MCP 客户端
发现模式,发送调用,并接收类型化内容。
SCADA MCP Server
验证请求并拥有 27 个已记录工具契约。
领域系统
维护服务器背后的 API、数据、凭证和业务规则。
来自项目文档
服务器发布的架构
工具目录
代理可以请求 SCADA MCP Server 做什么?
每个工具都有稳定名称、易读的用途和 MCP 初始化时发现的 JSON 输入契约。风险类别来自项目的注册清单(如果有)。
27 个命名工具
create_site注册一个站点(变电站/调节器/泵站/太阳能)
internal writelist_sites按行业列出站点
read onlycreate_asset在站点注册资产
internal writeget_asset获取资产(状态,锁定)
read onlylist_assets按站点/类型/状态列出资产
read onlyset_asset_state设置资产运行状态(影响控制联锁)
external writeset_lockout应用/解除锁定标签(阻止控制)
external writecreate_tag定义标签/点(模拟/状态/设定点/控制)
internal writeget_tag获取标签的值、范围、阈值
read onlylist_tags列出资产的标签及实时值
read onlyingest_reading摄取遥测读数(自动报警评估)
internal writetag_history标签的历史读数
read only治理
了解每个工具的作用。
服务器连接继承其凭证和部署环境的权限。以下声明来自本项目的 README 和 MCP 注册清单;您的应用程序仍决定代理接收哪些工具以及何处需要批准。
- 每条命令(issue_command)均执行联锁链,按顺序检查;仅全部通过时应用值,拒绝的命令被记录但不执行:
- 先模拟运行 — check_interlocks(只读)允许代理确认可行性后再请求需审批的命令。
- 需审批的外部写入 — issue_command、set_lockout和set_asset_state在清单中标记为external_write + requires_approval;风险等级为“关键”。
- 完整审计轨迹 — 每条命令(执行和拒绝)及状态变更均被记录(command_history,audit_log)。
- 参考引擎 — 这是内存中的参考实现。生产部署必须在RTU/PLC/现场级别及硬件层面强制执行这些联锁……
MCP 接口
当前文档声明的内容。
MCP 可传输工具、资源、提示、结构化结果、进度、取消和长时间运行的工作。此记录突出显示本仓库明确提及的现代协议特性。
安装并连接
遵循项目文档中的起点。
在拥有凭证和领域访问权限的环境中安装服务器。将其添加到您的 MCP 主机,验证发现的工具,并在交付生产代理前缩小工具集。
cargo install mcp-scadalet toolset = McpToolset::from_stdio(
"mcp-scada",
["mcp-scada"],
).await?;
let agent = LlmAgentBuilder::new("agent")
.tools(toolset.tools().await?)
.build()?;命令和配置从公开的 README 中提取。部署前请确认官方文档中的先决条件、环境变量和特定版本选项。
官方文档
继续使用项目维护者的权威信息源。
此页面提供服务器的易懂地图。仓库对确切的模式、先决条件、配置、示例、测试、版本和安全更新保持权威。
继续探索