关于 LadDoc Cloud — LadDoc to SimaticML over MCP
LadDoc Cloud 将 LadDoc IR 文档转换为可由 TIA Portal 导入的 V19 SimaticML,并在生成前进行严格校验。它面向 PLC 程序开发流程;相同输入会产生字节一致的输出,也可用项目清单检查符号。
主要功能
- 01查询服务实现的 LAD-IR 版本
- 02校验 LadDoc 文档并返回问题
- 03生成 FC、FB 或 OB 的 SimaticML
- 04校验通过后才生成 XML
- 05按项目清单检查符号
适用场景
- 01生成可导入 TIA Portal 的逻辑块
- 02在生成前定位 LadDoc 文档问题
- 03检查目标项目中的符号是否匹配
- 04重复生成一致的 SimaticML 输出
MCP 相关
该远程 MCP 服务通过 Streamable HTTP 提供版本查询、LadDoc 校验和 SimaticML 生成工具。生成工具仅在校验通过时输出内容。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://tia.hubwiz.com/lad/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http tia-forge-laddoc-cloud https://tia.hubwiz.com/lad/mcpCursor.cursor/mcp.json
{"mcpServers":{"tia-forge-laddoc-cloud":{"type":"http","url":"https://tia.hubwiz.com/lad/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"tia-forge-laddoc-cloud":{"type":"http","url":"https://tia.hubwiz.com/lad/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"tia-forge-laddoc-cloud":{"type":"http","url":"https://tia.hubwiz.com/lad/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"tia-forge-laddoc-cloud":{"serverUrl":"https://tia.hubwiz.com/lad/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
全部服务地址
Streamable HTTP
https://tia.hubwiz.com/lad/mcp需要授权工具
详细介绍
LadDoc Cloud — 通过 MCP 将 LadDoc 转换为 SimaticML
LadDoc Cloud 可将梯形逻辑文档(LadDoc IR)转换为 TIA Portal 可直接导入的 SimaticML,并在生成器前设置严格的验证关卡。
此仓库仅包含文档和客户端配置。服务运行在
tia.hubwiz.com;其实现并非开源。
- 端点:
https://tia.hubwiz.com/lad/mcp - 传输方式:Streamable HTTP(无状态,POST JSON-RPC)
- 身份验证:
Authorization: Bearer lad_live_…(也接受X-API-Key请求头) - 控制面板 / API 密钥:https://tia.hubwiz.com/lad
- 注册表条目:
io.github.tia-forge/laddoc-cloud(官方 MCP Registry)
功能
| 工具 | 用途 |
|---|---|
lad_version | 免费:返回此服务实现的 LAD-IR 标识信息(schemaVersion、bundleHash、sourceCommit) |
lad_validate | 验证一份 LadDoc 文档;返回 valid,以及包含 code / path / message 的 issues |
lad_generate | 生成 SimaticML 块(FC / FB / OB)——仅在验证通过时生成 |
值得了解的行为:
- 验证是关卡。 只要存在一项问题,就不会生成 XML——绝不会向 TIA Portal 提交无法导入的块。修复问题后重试;系统会完整返回剩余问题。
- 输出具有确定性。 相同的 LadDoc 始终生成字节完全相同的 SimaticML;
UId和连接由生成器分配。 - 目标格式:V19 SimaticML 文档。
- 可选交叉检查:传入目标项目的清单,以便在生成前发现符号不匹配。
- 每次调用处理一份文档:若要生成多个块,请按块分别调用(被调用的 FC/FB 需作为独立文档提交)。
快速开始
Claude Code
claude mcp add --transport http lad-cloud https://tia.hubwiz.com/lad/mcp \
--header "Authorization: Bearer lad_live_YOUR_KEY"
claude mcp list
Cursor / VS Code / 任意采用 JSON 配置的客户端
{
"mcpServers": {
"lad-cloud": {
"url": "https://tia.hubwiz.com/lad/mcp",
"headers": { "Authorization": "Bearer lad_live_YOUR_KEY" }
}
}
}
首次调用
// free — confirm which LAD-IR bundle this service implements
{ "name": "lad_version", "arguments": {} }
// validate, then generate
{ "name": "lad_validate", "arguments": { "doc": { "schemaVersion": "1.0", "block": { /* … */ } } } }
{ "name": "lad_generate", "arguments": { "doc": { /* same doc */ } } }
定价
在控制面板使用微信登录后即可立即获取密钥:免费调用 100 次。握手请求(initialize、tools/list)和 lad_version 均免费。
说明
- 此服务生成文本/XML,不会操作正在运行的 TIA Portal。若要导入结果并进行编译,请使用 TIA Portal 本身或本机网关(TiaLink)。
- 免费配套工具:PLC Cloud Sim 可在导入前运行逻辑。
- 文档许可证:CC BY 4.0。“TIA Portal”、“SIMATIC”和“S7”是 Siemens AG 的商标;此服务是独立的第三方工具,与 Siemens 无关联,也未获其认可。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。