摘要在 Windows TIA Portal V21 环境下通过 MCP 把大模型/自动化客户端接到西门子博途 Openness API实现建项目、配硬件、生成 PLCSCL/LAD/声明式 JSON、组态 WinCC Unified HMI、编译保存。本文基于交付包TIA_MCP_260514整理面向想「少点鼠标、多点对话」的工控工程师与自动化开发者。建议标签西门子TIA Portal博途MCPOpennessWinCC UnifiedPLCAI编程工控自动化 资源获取GitHub 源码仓库仓库地址https://github.com/bulaofen0036-coder/TIA_Portal_Openness_MCP内容完整的交付包源码、文档、模板和工具使用方式克隆或下载后按照本文第五节的「5 分钟接入 MCP」步骤配置使用演示视频视频标题屏幕录制 2026-05-23 142323.mp4网盘链接https://pan.baidu.com/s/11RpRw0dYQpk12nRu9bDAhw提取码y15i视频内容展示了从配置 MCP 客户端到生成完整 PLCHMI 项目的全过程演示一、为什么需要这套东西传统博途工程流里大量时间花在重复动作上建 CPU/HMI、拖 PROFINET、写接口 DB、导入块、编译、再一页页画 HMI、绑变量、配按钮事件。这些步骤规则性强、路径固定却难以用普通脚本一次性描述——因为最终都要落到TIA Openness的对象模型上。MCPModel Context Protocol的作用是把「博途能做什么」封装成一组结构化工具让 Cursor、VS Code、Claude Desktop 等支持 MCP 的客户端用自然语言或编排逻辑去调用而不是让人工逐条查 API 文档。本交付包的核心价值可以概括为三句话开箱即用内含已编译的TiaMcpServer.exe无需再克隆源码仓库。可验证的模板链PLC/HMI 使用 JSON 蓝图 PlcBuildAndImport/ UnifieddesignJson先dryRun再实际导入。文档与工具对齐184 个 MCP 工具、能力矩阵、运行手册、自然语言意图索引降低「AI 随意猜测路径」的概率。二、整体架构一张图看懂西门子环境交付包内桥接层MCP 客户端MCP JSON-RPCOpennessCursor / VS Code / Claude Desktop / 自研 HTTP 客户端TiaMcpServer.exestdio 或 HTTPSkill 手册 模板 JSONTIA Portal V21Openness Public API工程PLC WinCC Unified要点MCP 与具体 IDE无关某个客户端「工具列表不全」通常是客户端缓存/描述符问题不是交付包裁掉了能力见包内docs/mcp-ide-and-tool-visibility.md。运行时工具列表以连接服务器后的tools/list为准包内manifest/tools-list.json是静态快照当前为184个工具L0×6、L1×29、L2×149。三、交付包里有什么类别路径包内相对路径作用运行时tools/tiaportal-mcp/src/TiaMcpServer/bin/Release/net48/TiaMcpServer.exeMCP 服务端接入示例cursor-mcp.example.json复制到客户端 MCP 配置把REPLACE_ME换成包根目录主规范tools/tiaportal-mcp/skill/SKILL.md工具分层、参数陷阱、HMI schema工具清单manifest/tools-list.json、docs/tool-capability-matrix.md静态索引完整蓝图templates/project-blueprints/full_plc_hmi_project.json从零生成 PLCUnified 的「剧本」运行手册docs/full-project-generation-runbook.md分步 MCP 调用顺序PLC 模板templates/plc/plcbuild-json/*.json、LAD 配方、SCL 示例声明式建块HMI 模板templates/hmi/unified_*.jsonWinCC Unified 画面 designJson校验脚本scripts/Validate-Bundle.ps1不启动博途即可检查包完整性手册手册/quickstart.md、手册/openness-limitations.md、手册/TIA_NL_INTENT_RECIPES.md速启、边界、NL→工具序列不包含TIA 安装介质、现场专有工艺逻辑、西门子未公开的「伪能力」。业务程序仍需在模板之上扩展。四、环境准备上线前 checklist操作系统Windows运行时.NET Framework4.8博途TIA Portal V21包目标主版本其它版本需自行验证 PublicAPI权限当前 Windows 用户加入Siemens TIA Openness组注销后重新登录环境变量TiaPortalLocation指向 Portal 安装根例如C:\Program Files\Siemens\Automation\Portal V21首次连接在 TIA 弹窗中允许 Openness 访问可用 PowerShell 粗查 Openness 组whoami/groups|findstr Openness五、5 分钟接入 MCPstdio推荐1. 脱机校验交付包在包根目录包含README.md的文件夹执行powershell-NoProfile-ExecutionPolicy Bypass-File.\scripts\Validate-Bundle.ps1通过后再连接博途需要更严格比对时可加-Strict。2. 配置客户端将cursor-mcp.example.json中的片段合并到你的 MCP 配置例如 Cursor 的mcp.json{mcpServers:{tia-portal:{command:C:\\你的包根目录\\tools\\tiaportal-mcp\\src\\TiaMcpServer\\bin\\Release\\net48\\TiaMcpServer.exe,args:[],env:{}}}}若系统未设置TiaPortalLocation在env中补上同名变量。3. 首次调用顺序不要跳步Bootstrap → Connect → OpenProject 或 CreateProject → GetProjectTreeBootstrap只读定向返回 TIA 版本、Openness 组状态、推荐下一步不会自动连接博途。GetProjectTree打开工程后必调所有PLC_1、HMI_RT_xxx路径都应来自真实树禁止硬编码猜测路径。可选冒烟RunCapabilitySelfTest。4. HTTP 传输进阶TiaMcpServer.exe--transport http--http-prefix http://127.0.0.1:8765/--http-api-key secret注意POST /mcp是完整 MCP 会话不是裸tools/call自研脚本需实现 initialize 等协议步骤详见SKILL.md。六、两条典型工作路径路径 A从零生成「PLC WinCC Unified」全套读templates/project-blueprints/full_plc_hmi_project.jsondocs/full-project-generation-runbook.md标准闭环缩写Bootstrap → Connect → CreateProject → AddDeviceWithFallback → AddHardwareCatalogDeviceWithProbe → ConnectDeviceNodesToProfinetSubnet → GetProjectTree → ValidateAutomationContext → PlcBuildAndImport每项先 dryRuntrue再按顺序 dryRunfalse → CompileAndDiagnosePlc → EnsureUnifiedHmiConnection → EnsureUnifiedHmiTagTable → EnsureUnifiedHmiTag → EnsureUnifiedHmiScreen → ApplyUnifiedHmiScreenDesignJson → BindUnifiedHmiTagDynamization → EnsureUnifiedHmiButtonAction → SaveProject → DisconnectPLC 导入顺序蓝图约定tagtable → udt → globaldb → fc → fb → ladRecipe → externalSclExample → compileHMI 绑定策略重要接口 DBDB_HMI_Interface使用**非优化Standard**访问字节布局见templates/plc/plcbuild-json/db_hmi_interface.json的absoluteLayout。调用EnsureUnifiedHmiTag时同时传plcTag与address如plcTagDB_HMI_Interface.CmdEnable、address%DB200.DBX0.0。顺序PLC 编译通过→ HMI 连接 → 变量表 → 画面 → 动态化 → 按钮 Down/Up 动作。路径 B只验证 MCP / 导入链路读templates/mcp-full-e2e-verify/README.md在已有工程中按说明导入块与标签再CompileAndDiagnosePlc。七、工具分层AI 应该先调谁层级数量快照典型工具设计意图L06Bootstrap、RunCapabilitySelfTest、GetState环境定向、只读自检L129Connect、CreateProject、GetProjectTree、PlcBuildAndImport、CompileAndDiagnosePlc、AddDeviceWithFallback高频、参数已收敛的「首选」L2149AddDevice、EnsureSubnet、各类 HMI/反射探测细粒度、需明确路径或高级场景对自然语言用户包内手册/TIA_NL_INTENT_RECIPES.md提供「意图 → 工具序列」索引减少模型自由发挥。PLC 建块首选PlcBuildAndImportJSON 描述一块先dryRuntrue校验再导入编译。硬件插入首选AddDeviceWithFallback按系列探测目录第三方 GSD 用AddGsdDeviceWithProbe。八、能力边界Openness 做不到的事交付包诚实标注了 Public API 限制详见手册/openness-limitations.md例如需求Openness / 本 MCP建议替代读 CPURUN/STOP 运行模式不支持面板指示灯、HMI、OPC UA诊断缓冲区、部分强制写入的「即时生效」不支持或受限OPC UA在线改 PLC 实际值随意写 IO不暴露为随意写工具OPC UA / 专用通信库已支持工程态在线/离线连接状态、GoOnline/GoOffline、下载前检查、DownloadToPlc会改变现场 PLC 行为务必安全确认、离线/在线软件比较、结构化编译诊断等。九、模板与指令库不是黑盒生成器交付包里的 PLC/HMI 内容是通用示范便于二次改参SCLdocs/scl-instruction-library.mdtemplates/plc/scl-examples/LADdocs/lad-instruction-library.mdtemplates/plc/lad-recipes/HMI 画面规范docs/HMI_Unified_画面生成规范与模板.md通讯驱动匹配docs/hmi-connection-driver-matrix.md按 CPU 系列选CommunicationDriver把模板当「可编译的脚手架」工艺与安全联锁仍须工程负责人审核。十、常见问题排障速查现象处理TIA Portal not running先手动打开博途工程树为空OpenProject/CreateProject/AttachToOpenProjectOpenness 拒绝访问检查 Windows 组 TIA 授权弹窗 TiaPortalLocationHMI 变量地址红字对照docs/hmi-plc-tag-binding-and-addressing.md确认%DB200...与 DB 布局一致客户端工具比文档少以运行时tools/list为准重启客户端清缓存MCP HTTP 卡住勿用裸 POST改用 stdio 或完整 MCP 客户端更完整的错误形态见手册/error-model.md。十一、和「只会写 SCL 的 Copilot」差在哪维度只生成 SCL 文本TIA Portal MCP 交付包输出源码片段真实 .ap21 工程变更设备、块、HMI、编译结果路径人手工导入Openness 自动导入 GetProjectTree约束路径HMI常缺失Unified 连接、变量、designJson、按钮事件、动态化验证人眼编译CompileAndDiagnosePlc结构化错误列表可重复低蓝图 JSON Validate-Bundle.ps1 dryRun适合教学演示、标准机台骨架、重复性组态、与 AI 结对调试接口 DB/HMI 绑定不适合替代安全认证、替代工艺设计、无 TIA 许可的「云编博途」。十二、使用建议与注意事项标题优化可根据实际应用场景调整标题突出「MCP 博途 V21 WinCC Unified 一键生成」的核心价值。配图建议建议补充三张关键截图——MCP 客户端配置界面、GetProjectTree返回的工程树结构、编译成功后的HMI画面预览。安全提示涉及DownloadToPlc等在线操作时务必在安全环境下进行避免影响生产设备。分发说明若分享此交付包请确保包含完整的README.md和校验脚本不要只提供可执行文件。十三、延伸阅读包内路径总览README.md英语速启手册/quickstart.md清单元数据manifest/package-manifest.json完整生成docs/full-project-generation-runbook.md本文根据交付包TIA_MCP_260514manifest 标注生成时间 2026-05-12整理工具数以包内manifest/tools-list.json为准。若你使用的构建版本不同请以连上 MCP 后的tools/list为最终依据。最后开发不易朋友们如果觉得不错帮忙点点github⭐标
用自然语言驱动博途:TIA Portal MCP 完整交付包导读(V21)——附源码与演示视频
发布时间:2026/6/4 22:43:04
摘要在 Windows TIA Portal V21 环境下通过 MCP 把大模型/自动化客户端接到西门子博途 Openness API实现建项目、配硬件、生成 PLCSCL/LAD/声明式 JSON、组态 WinCC Unified HMI、编译保存。本文基于交付包TIA_MCP_260514整理面向想「少点鼠标、多点对话」的工控工程师与自动化开发者。建议标签西门子TIA Portal博途MCPOpennessWinCC UnifiedPLCAI编程工控自动化 资源获取GitHub 源码仓库仓库地址https://github.com/bulaofen0036-coder/TIA_Portal_Openness_MCP内容完整的交付包源码、文档、模板和工具使用方式克隆或下载后按照本文第五节的「5 分钟接入 MCP」步骤配置使用演示视频视频标题屏幕录制 2026-05-23 142323.mp4网盘链接https://pan.baidu.com/s/11RpRw0dYQpk12nRu9bDAhw提取码y15i视频内容展示了从配置 MCP 客户端到生成完整 PLCHMI 项目的全过程演示一、为什么需要这套东西传统博途工程流里大量时间花在重复动作上建 CPU/HMI、拖 PROFINET、写接口 DB、导入块、编译、再一页页画 HMI、绑变量、配按钮事件。这些步骤规则性强、路径固定却难以用普通脚本一次性描述——因为最终都要落到TIA Openness的对象模型上。MCPModel Context Protocol的作用是把「博途能做什么」封装成一组结构化工具让 Cursor、VS Code、Claude Desktop 等支持 MCP 的客户端用自然语言或编排逻辑去调用而不是让人工逐条查 API 文档。本交付包的核心价值可以概括为三句话开箱即用内含已编译的TiaMcpServer.exe无需再克隆源码仓库。可验证的模板链PLC/HMI 使用 JSON 蓝图 PlcBuildAndImport/ UnifieddesignJson先dryRun再实际导入。文档与工具对齐184 个 MCP 工具、能力矩阵、运行手册、自然语言意图索引降低「AI 随意猜测路径」的概率。二、整体架构一张图看懂西门子环境交付包内桥接层MCP 客户端MCP JSON-RPCOpennessCursor / VS Code / Claude Desktop / 自研 HTTP 客户端TiaMcpServer.exestdio 或 HTTPSkill 手册 模板 JSONTIA Portal V21Openness Public API工程PLC WinCC Unified要点MCP 与具体 IDE无关某个客户端「工具列表不全」通常是客户端缓存/描述符问题不是交付包裁掉了能力见包内docs/mcp-ide-and-tool-visibility.md。运行时工具列表以连接服务器后的tools/list为准包内manifest/tools-list.json是静态快照当前为184个工具L0×6、L1×29、L2×149。三、交付包里有什么类别路径包内相对路径作用运行时tools/tiaportal-mcp/src/TiaMcpServer/bin/Release/net48/TiaMcpServer.exeMCP 服务端接入示例cursor-mcp.example.json复制到客户端 MCP 配置把REPLACE_ME换成包根目录主规范tools/tiaportal-mcp/skill/SKILL.md工具分层、参数陷阱、HMI schema工具清单manifest/tools-list.json、docs/tool-capability-matrix.md静态索引完整蓝图templates/project-blueprints/full_plc_hmi_project.json从零生成 PLCUnified 的「剧本」运行手册docs/full-project-generation-runbook.md分步 MCP 调用顺序PLC 模板templates/plc/plcbuild-json/*.json、LAD 配方、SCL 示例声明式建块HMI 模板templates/hmi/unified_*.jsonWinCC Unified 画面 designJson校验脚本scripts/Validate-Bundle.ps1不启动博途即可检查包完整性手册手册/quickstart.md、手册/openness-limitations.md、手册/TIA_NL_INTENT_RECIPES.md速启、边界、NL→工具序列不包含TIA 安装介质、现场专有工艺逻辑、西门子未公开的「伪能力」。业务程序仍需在模板之上扩展。四、环境准备上线前 checklist操作系统Windows运行时.NET Framework4.8博途TIA Portal V21包目标主版本其它版本需自行验证 PublicAPI权限当前 Windows 用户加入Siemens TIA Openness组注销后重新登录环境变量TiaPortalLocation指向 Portal 安装根例如C:\Program Files\Siemens\Automation\Portal V21首次连接在 TIA 弹窗中允许 Openness 访问可用 PowerShell 粗查 Openness 组whoami/groups|findstr Openness五、5 分钟接入 MCPstdio推荐1. 脱机校验交付包在包根目录包含README.md的文件夹执行powershell-NoProfile-ExecutionPolicy Bypass-File.\scripts\Validate-Bundle.ps1通过后再连接博途需要更严格比对时可加-Strict。2. 配置客户端将cursor-mcp.example.json中的片段合并到你的 MCP 配置例如 Cursor 的mcp.json{mcpServers:{tia-portal:{command:C:\\你的包根目录\\tools\\tiaportal-mcp\\src\\TiaMcpServer\\bin\\Release\\net48\\TiaMcpServer.exe,args:[],env:{}}}}若系统未设置TiaPortalLocation在env中补上同名变量。3. 首次调用顺序不要跳步Bootstrap → Connect → OpenProject 或 CreateProject → GetProjectTreeBootstrap只读定向返回 TIA 版本、Openness 组状态、推荐下一步不会自动连接博途。GetProjectTree打开工程后必调所有PLC_1、HMI_RT_xxx路径都应来自真实树禁止硬编码猜测路径。可选冒烟RunCapabilitySelfTest。4. HTTP 传输进阶TiaMcpServer.exe--transport http--http-prefix http://127.0.0.1:8765/--http-api-key secret注意POST /mcp是完整 MCP 会话不是裸tools/call自研脚本需实现 initialize 等协议步骤详见SKILL.md。六、两条典型工作路径路径 A从零生成「PLC WinCC Unified」全套读templates/project-blueprints/full_plc_hmi_project.jsondocs/full-project-generation-runbook.md标准闭环缩写Bootstrap → Connect → CreateProject → AddDeviceWithFallback → AddHardwareCatalogDeviceWithProbe → ConnectDeviceNodesToProfinetSubnet → GetProjectTree → ValidateAutomationContext → PlcBuildAndImport每项先 dryRuntrue再按顺序 dryRunfalse → CompileAndDiagnosePlc → EnsureUnifiedHmiConnection → EnsureUnifiedHmiTagTable → EnsureUnifiedHmiTag → EnsureUnifiedHmiScreen → ApplyUnifiedHmiScreenDesignJson → BindUnifiedHmiTagDynamization → EnsureUnifiedHmiButtonAction → SaveProject → DisconnectPLC 导入顺序蓝图约定tagtable → udt → globaldb → fc → fb → ladRecipe → externalSclExample → compileHMI 绑定策略重要接口 DBDB_HMI_Interface使用**非优化Standard**访问字节布局见templates/plc/plcbuild-json/db_hmi_interface.json的absoluteLayout。调用EnsureUnifiedHmiTag时同时传plcTag与address如plcTagDB_HMI_Interface.CmdEnable、address%DB200.DBX0.0。顺序PLC 编译通过→ HMI 连接 → 变量表 → 画面 → 动态化 → 按钮 Down/Up 动作。路径 B只验证 MCP / 导入链路读templates/mcp-full-e2e-verify/README.md在已有工程中按说明导入块与标签再CompileAndDiagnosePlc。七、工具分层AI 应该先调谁层级数量快照典型工具设计意图L06Bootstrap、RunCapabilitySelfTest、GetState环境定向、只读自检L129Connect、CreateProject、GetProjectTree、PlcBuildAndImport、CompileAndDiagnosePlc、AddDeviceWithFallback高频、参数已收敛的「首选」L2149AddDevice、EnsureSubnet、各类 HMI/反射探测细粒度、需明确路径或高级场景对自然语言用户包内手册/TIA_NL_INTENT_RECIPES.md提供「意图 → 工具序列」索引减少模型自由发挥。PLC 建块首选PlcBuildAndImportJSON 描述一块先dryRuntrue校验再导入编译。硬件插入首选AddDeviceWithFallback按系列探测目录第三方 GSD 用AddGsdDeviceWithProbe。八、能力边界Openness 做不到的事交付包诚实标注了 Public API 限制详见手册/openness-limitations.md例如需求Openness / 本 MCP建议替代读 CPURUN/STOP 运行模式不支持面板指示灯、HMI、OPC UA诊断缓冲区、部分强制写入的「即时生效」不支持或受限OPC UA在线改 PLC 实际值随意写 IO不暴露为随意写工具OPC UA / 专用通信库已支持工程态在线/离线连接状态、GoOnline/GoOffline、下载前检查、DownloadToPlc会改变现场 PLC 行为务必安全确认、离线/在线软件比较、结构化编译诊断等。九、模板与指令库不是黑盒生成器交付包里的 PLC/HMI 内容是通用示范便于二次改参SCLdocs/scl-instruction-library.mdtemplates/plc/scl-examples/LADdocs/lad-instruction-library.mdtemplates/plc/lad-recipes/HMI 画面规范docs/HMI_Unified_画面生成规范与模板.md通讯驱动匹配docs/hmi-connection-driver-matrix.md按 CPU 系列选CommunicationDriver把模板当「可编译的脚手架」工艺与安全联锁仍须工程负责人审核。十、常见问题排障速查现象处理TIA Portal not running先手动打开博途工程树为空OpenProject/CreateProject/AttachToOpenProjectOpenness 拒绝访问检查 Windows 组 TIA 授权弹窗 TiaPortalLocationHMI 变量地址红字对照docs/hmi-plc-tag-binding-and-addressing.md确认%DB200...与 DB 布局一致客户端工具比文档少以运行时tools/list为准重启客户端清缓存MCP HTTP 卡住勿用裸 POST改用 stdio 或完整 MCP 客户端更完整的错误形态见手册/error-model.md。十一、和「只会写 SCL 的 Copilot」差在哪维度只生成 SCL 文本TIA Portal MCP 交付包输出源码片段真实 .ap21 工程变更设备、块、HMI、编译结果路径人手工导入Openness 自动导入 GetProjectTree约束路径HMI常缺失Unified 连接、变量、designJson、按钮事件、动态化验证人眼编译CompileAndDiagnosePlc结构化错误列表可重复低蓝图 JSON Validate-Bundle.ps1 dryRun适合教学演示、标准机台骨架、重复性组态、与 AI 结对调试接口 DB/HMI 绑定不适合替代安全认证、替代工艺设计、无 TIA 许可的「云编博途」。十二、使用建议与注意事项标题优化可根据实际应用场景调整标题突出「MCP 博途 V21 WinCC Unified 一键生成」的核心价值。配图建议建议补充三张关键截图——MCP 客户端配置界面、GetProjectTree返回的工程树结构、编译成功后的HMI画面预览。安全提示涉及DownloadToPlc等在线操作时务必在安全环境下进行避免影响生产设备。分发说明若分享此交付包请确保包含完整的README.md和校验脚本不要只提供可执行文件。十三、延伸阅读包内路径总览README.md英语速启手册/quickstart.md清单元数据manifest/package-manifest.json完整生成docs/full-project-generation-runbook.md本文根据交付包TIA_MCP_260514manifest 标注生成时间 2026-05-12整理工具数以包内manifest/tools-list.json为准。若你使用的构建版本不同请以连上 MCP 后的tools/list为最终依据。最后开发不易朋友们如果觉得不错帮忙点点github⭐标