LadDoc Cloud — LadDoc to SimaticML over MCP

LadDoc Cloud — MCP 経由の LadDoc → SimaticML

LadDoc Cloud はラダー図ドキュメント（LadDoc IR）を SimaticML に変換します。TIA Portal に直接インポートでき、ジェネレーターの実行前に厳格な検証ゲートを設けています。

このリポジトリに含まれるのは、ドキュメントとクライアント設定のみです。サービスは 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 ドキュメントを1件検証し、code／path／message を含む issues と valid を返します
lad_generate	SimaticML ブロック（FC／FB／OB）を生成します — 検証に合格した場合のみ

知っておくと便利な動作：

• 検証がゲートになります。 問題が1件でもあれば XML は生成されません。TIA Portal にインポートできないブロックを渡すことはありません。修正して再試行すると、残りの問題がすべて返されます。
• 出力は決定論的です。 同じ LadDoc からは常にバイト単位で同一の SimaticML が生成されます。UId と接続はジェネレーターが割り当てます。
• 対象フォーマット：V19 SimaticML ドキュメント。
• 任意の照合：生成前にシンボルの不一致を検出するには、対象プロジェクトのインベントリを渡します。
• 1回の呼び出しにつきドキュメントは1件です。複数のブロックを生成するには、ブロックごとに1回呼び出します（呼び出される 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 */ } } }

料金

ダッシュボードで WeChat ログインすると、キーがすぐに発行されます。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 との提携や同社による承認を受けていません。