LadDoc Cloud — LadDoc to SimaticML over MCP

io.github.tia-forge由 GitHub 帳號 tia-forge 發布v0.1.1更新於 Oct 25, 2026

Generate TIA Portal importable SimaticML (V19) from LadDoc IR, with strict validation, over MCP.

已驗證Streamable HTTP可網頁執行效率與工作流開發者工具

概覽

AI 產生的概覽

遠端 MCP 服務，用於驗證梯形圖 LadDoc 文件並產生可匯入 TIA Portal 的 SimaticML（V19）區塊。

可以做什麼
查詢此服務實作的 LAD-IR 身分資訊，包括 schemaVersion、bundleHash 與 sourceCommit（lad_version）。驗證單一 LadDoc 文件，回傳 valid 以及含 code、path、message 的 issues（lad_validate）。僅在驗證通過時產生 SimaticML 區塊（FC、FB 或 OB），輸出確定且位元組一致，UId 與連線由產生器指派（lad_generate）。可選擇傳入目標專案清單做交叉檢查，在產生前找出符號不符。每次呼叫只處理一份文件，多個區塊需多次呼叫。
適用情境
當你已有以 LadDoc IR 表示的梯形圖邏輯，希望由助理檢查並產生可匯入 TIA Portal V19 的 SimaticML 時適用。驗證門檻適合絕不能讓無法匯入的區塊進入 PLC 專案的流程。
執行需求
遠端 Streamable HTTP 端點，無需本機套件或執行環境。需要 Bearer API 金鑰，透過 Authorization 標頭傳送（也接受 X-API-Key 標頭），金鑰須在提供者主控台取得；在該處以微信登入可獲得 100 次呼叫的免費金鑰。需要能連線至提供者主機的網路。
安裝前請注意
Authorization 標頭攜帶金鑰，請避免寫入共用設定或日誌。超出免費額度後依提供者定價計費，反覆驗證重試會消耗額度。此服務只輸出文字/XML，不接觸執行中的 TIA Portal，匯入與編譯需另行完成。它是獨立第三方工具，與西門子無隸屬關係。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 LadDoc Cloud — LadDoc to SimaticML over MCP，將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.tia-forge%2Fladdoc-cloud/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "laddoc-cloud-laddoc-to-simaticml-over": {
      "type": "http",
      "url": "https://tia.hubwiz.com/lad/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

LadDoc Cloud — LadDoc → SimaticML over MCP

LadDoc Cloud turns a ladder-logic document (LadDoc IR) into SimaticML that TIA Portal imports directly — with a strict validation gate in front of the generator.

This repository is documentation and client configuration only. The service runs at tia.hubwiz.com; its implementation is not open source.

  • Endpoint: https://tia.hubwiz.com/lad/mcp
  • Transport: Streamable HTTP (stateless, POST JSON-RPC)
  • Auth: Authorization: Bearer lad_live_… (the X-API-Key header is also accepted)
  • Dashboard / API keys: https://tia.hubwiz.com/lad
  • Registry entry: io.github.tia-forge/laddoc-cloud (official MCP Registry)

What it does

ToolPurpose
lad_versionFree: returns the LAD-IR identity this service implements (schemaVersion, bundleHash, sourceCommit)
lad_validateValidate one LadDoc document; returns valid plus issues with code / path / message
lad_generateGenerate a SimaticML block (FC / FB / OB) — only if validation passes

Behaviour worth knowing:

  • Validation is the gate. One issue and no XML is produced — you never hand TIA Portal a block that cannot be imported. Fix and retry; the remaining issues come back in full.
  • Deterministic output. The same LadDoc always produces byte-identical SimaticML; UIds and connections are assigned by the generator.
  • Target format: V19 SimaticML documents.
  • Optional cross-check: pass the target project's inventory to catch symbol mismatches before generation.
  • One document per call: to generate several blocks, call once per block (called FC/FBs are submitted as their own documents).

Quick start

Claude Code

bash
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 / any JSON-configured client

json
{  "mcpServers": {    "lad-cloud": {      "url": "https://tia.hubwiz.com/lad/mcp",      "headers": { "Authorization": "Bearer lad_live_YOUR_KEY" }    }  }}

First calls

jsonc
// 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 */ } } }

Pricing

WeChat login on the dashboard issues a key immediately: 100 calls free. Handshake requests (initialize, tools/list) and lad_version are free.

Notes

  • This service produces text/XML; it does not touch a running TIA Portal. To import the result and compile it, use TIA Portal itself or the on-machine gateway (TiaLink).
  • Free companion: PLC Cloud Sim runs the logic before you import it.
  • Documentation license: CC BY 4.0. "TIA Portal", "SIMATIC" and "S7" are trademarks of Siemens AG; this service is an independent third-party tool, not affiliated with or endorsed by Siemens.

來源：README.md，提交 a21c4f6

工具

0
該伺服器需要 API 金鑰等憑證，因此 SourceWeft 無法在沒有憑證的情況下讀取其工具，也未收錄。

版本歷史

1
  1. v0.1.1最新Oct 25, 2026

評分

已滿足適用檢查項的 75%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。