SuperAPI AI 工具集

tia-portal-mcp

智能体与模型

查看项目

更新于 10-16 05:05

技能介绍

用途:通过 MCP 服务器直接与 TIA Portal 交互,适合探索、检查和有边界的变更。循环、批量自动化或超出该工具面的操作应改用 tia-openness-roadmap。

主要能力:服务器仅暴露十个公开 MCP 工具,分三类批处理工具与七个项目生命周期工具。数据操作包括 execute_read_batch(最多 50 个独立读操作)、preview_write_batch(预览最多 50 个写操作并获取一个批次安全令牌)、apply_write_batch(按顺序应用已预览的写批次,首个失败即停止并将其余标记为跳过,无事务或回滚)。读操作名包括 browse_project_tree、get_block_content、list_tag_tables、read_hardware_config、read_cross_references、search_equipment_catalog、compile_check、get_project_status;写操作名包括块、标签表、标签、用户常量及网络设备操作,如 update_block_logic、create_block、create_tag、add_network_device。生命周期工具包括 get_project_status、open_project、create_project、save_project、save_project_as、archive_project、close_project。

使用方式:所有写入使用一次性、短时效安全令牌,绑定规范化项目路径、精确输入、目标与当前项目状态,不得自造或复用。数据写入需先把完整有序操作数组发给 preview_write_batch,审查预览与 safetyToken,再将未改动的数组连同 confirm:true 和该令牌发给 apply_write_batch。生命周期写入由工具自身预览:先不带 safetyToken 调用以获得预览和令牌,再以相同输入、confirm:true 和令牌调用应用;生命周期写入仅限单工具,不能放入数据批次。save_project_as 需 rebind:true,传 rebind:false 会在预览、发令牌、Siemens SaveAs 或审计前被拒绝为 validation_error。

限制:get_project_status(projectPath) 只读且非绑定,不会打开或切换项目;若绑定会话与状态请求路径不同,结果为 binding_conflict。worker_timeout、worker_crashed 或协议丢失后不得自动重试写入,结果可能不确定,应先检查当前状态再另行授权。写失败返回 failureCategory,支持 validation_error、binding_conflict、state_changed、worker_operation_failed、worker_timeout、worker_crashed、postcondition_failed;warnings 为非致命降级说明,不改变失败结论,出现警告应视为返回载荷可能不完整。