TiaLink

TiaLink — TIA Portal MCP ゲートウェイ

TiaLink は、汇智网 (hubwiz.com) が提供する TIA Portal MCP ゲートウェイです。 MCP に対応した任意の AI エージェントから、Siemens TIA Portal プロジェクトを直接操作できます。

📄 製品ページ：https://tia.hubwiz.com/tia-link

---

できること

TiaLink は Siemens TIA Portal の機能を MCP ツールとして公開するため、AI エージェントは次の操作を行えます。

• ハードウェアとネットワークの設定 — デバイスやモジュールの追加、IP アドレスの割り当て、サブネットや IO システムの作成
• プログラムとデータの操作 — FB / FC / DB / UDT ブロックの作成、SCL の記述、SimaticML ブロック（LAD を含む）のインポート
• ビルド — プロジェクトのコンパイル、保存、エクスポート、アーカイブ
• シミュレーションと検証 — S7-PLCSIM Advanced へのダウンロード、変数の読み書き、テストシナリオの実行
• 読み戻し — 検証用のプロジェクトモデル、ブロックインターフェース、ハードウェアツリー

つまり、チャットウィンドウにコードスニペットを表示するだけでなく、エージェントが実際の TIA Portal プロジェクトを操作し、結果を読み戻します。

---

仕組み

AI agent (MCP client)
        │  MCP (Streamable HTTP, endpoint /mcp)
        ▼
     TiaLink  ──►  Siemens TIA Portal Openness  ──►  TIA Portal project

• プロトコル：MCP（Model Context Protocol）、Streamable HTTP、エンドポイント /mcp
• 基盤：Siemens TIA Portal Openness
• エージェントを選びません：TiaLink は特定のモデルやベンダーに限定されません。Streamable HTTP に対応し、Bearer ヘッダーを送信できる MCP クライアントであれば接続できます。

---

はじめに

1. マシンを確認する — Windows、ライセンス済みの TIA Portal V19 または V20（V21 はまだサポートされていません）、およびローカルの Siemens TIA Openness グループに属する Windows アカウントが必要です。チェックリストの全項目は install.md をご覧ください。
2. 購入してダウンロードする — TiaLink は有料ソフトウェアです。料金は 月額 ¥99、または年額 ¥999（中国）です。製品ページで購入してください。WeChat Pay で支払い後、ダウンロードリンクとセットアップ手順がすぐに表示されます。ライセンス申請に注文番号が必要なため、保管してください。
3. MCP クライアントをゲートウェイに接続する — Claude Code、Cursor、VS Code、Claude Desktop 向けの設定例は examples/ にあります。
4. 動作を確認する — ツールの一覧を取得し、テスト用プロジェクトを読み込んだうえで、ブロックを 1 つ作成してコンパイル結果を確認します。手順 3 で問題が発生した場合は、install.md のトラブルシューティング表をご覧ください。

クライアントが stdio にしか対応していない場合

TiaLink は Streamable HTTP を提供します。ほとんどのクライアントはそのまま処理できますが、一部の デスクトップホストやワンクリックバンドルは stdio サーバーしか起動できません。その場合は、このリポジトリにある小さなアダプター server/index.js を使います。 stdio とゲートウェイ間で JSON-RPC を転送するだけで、独自の機能は追加しません。

⚠️ アダプターは製品ではありません。 事前にライセンス済みの TiaLink ゲートウェイを 起動しておく必要があります。ゲートウェイがなければ、設計どおり最初のリクエストで失敗します。

# Run the adapter against a local gateway
TIALINK_URL=http://127.0.0.1:8080/mcp npx tialink-mcp

# Pre-flight: is the gateway reachable, is the token right, which tools exist?
TIALINK_URL=http://192.168.1.78:8080/mcp TIALINK_TOKEN=... npx tialink-mcp --check

パス	内容
npx tialink-mcp	stdio ↔ HTTP アダプター（npm、依存関係なし、Node ≥ 18）
manifest.json + .mcpb	ワンクリックのデスクトップバンドル — npx @anthropic-ai/mcpb pack .
Dockerfile	Linux CI とサンドボックス化されたエージェント向けの、コンテナー内で動作する同じアダプター

環境変数で設定します：TIALINK_URL（デフォルト http://127.0.0.1:8080/mcp）、TIALINK_TOKEN、TIALINK_TIMEOUT_MS（デフォルト 600000 — コンパイルやダウンロードの呼び出しは、意図的に時間がかかります）。

デプロイ

• TiaLink は TIA Portal と同じ Windows マシン上で動作します（Openness は TIA Portal がインストールされた環境でのみ動作します）。
• MCP クライアントは別のマシンでも実行でき、LAN 経由で接続できます。例：http://<gateway-host>:8080/mcp。
• プロジェクトデータがローカルネットワークの外に出ることはありません。 オフライン環境やオンプレミス環境に適しています。
• 推奨：API トークンを設定してください。MCP クライアントはこれを Bearer ヘッダーとして送信します。

---

サポート対象のクライアント

Streamable HTTP をサポートし、Bearer ヘッダーを送信できる MCP クライアントであれば利用できます。例：

• Claude Code
• Cursor
• VS Code

TiaLink は特定のベンダーに依存しません。同じゲートウェイをさまざまなエージェント（Tencent WorkBuddy やその他の MCP クライアントを含む）で利用できます。

---

MCP 設定例

{
  "mcpServers": {
    "tialink": {
      "type": "http",
      "url": "http://192.168.1.78:8080/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_TOKEN>"
      }
    }
  }
}

192.168.1.78 を TiaLink を実行しているマシンの IP アドレスまたはホスト名に、<YOUR_API_TOKEN> を設定済みのトークンに置き換えてください。トークンをファイルではなく環境変数から読み込むものを含む、特定のクライアント向けの設定は examples/ にあります。

---

TIA Forge スイートの関連ツール

TiaLink は、汇智网 の TIA Portal エンジニアリングエージェントスイート TIA Forge の一部です。

• reverse-docs — 既存の PLC プロジェクトのリバースエンジニアリングドキュメント
• lad2scl / txt2scl / txt2lad — LAD / SCL / テキストの変換
• block-sim — ブロックレベルのシミュレーション

その他の掲載先

• Awesome PLC AI — 汇智网 が管理する、PLC エンジニアリング（Siemens TIA Portal、CODESYS、TwinCAT、Studio 5000、GX Works）向けの AI ツール、エージェント、MCP ブリッジを厳選したリストです。TiaLink は代替ツールとともに、開示事項を添えて掲載されています。
• SkillHub — Agent Skill としてパッケージ化されたゲートウェイ（skillhub install tialink-tia-portal）です。前提条件、接続設定、初回セッションの検証、安全規則を、README をざっと読む人ではなく、それを読み込むエージェント向けに記載しています。同じパブリッシャーから、次の 3 つの関連スキルも提供されています：LadDoc → SimaticML、クラウドシミュレーション、TIA Portal ドキュメント検索。

---

FAQ

TiaLink とは何ですか？ TiaLink は、汇智网（hubwiz.com）による TIA Portal 用の MCP ゲートウェイです。MCP プロトコルを通じて、あらゆる AI エージェントから Siemens TIA Portal プロジェクトを操作できます。

TiaLink の利用にインターネット接続は必要ですか？ いいえ。TiaLink は TIA Portal と同じマシン上で動作し、すべての操作はローカルで行われ、プロジェクトデータはオンプレミスに保管されます。

MCP ゲートウェイは TIA Portal と同じコンピューター上に置く必要がありますか？ ゲートウェイ自体は TIA Portal と同じマシン上で実行する必要があります（Openness が必要とするためです）。一方、MCP クライアントは別のマシン上で実行し、LAN 経由で接続できます。

TiaLink は特定の AI ベンダーに依存しますか？ いいえ。TiaLink は特定のエージェントに依存しません。Bearer ヘッダー付きの Streamable HTTP をサポートする MCP クライアントであれば、どれでも利用できます。

AI が生成した PLC コードをそのまま使用できますか？ AI が対応するのは検証可能なソフトウェア部分ですが、安全機能はハードウェア（安全リレー／安全 PLC）に実装する必要があります。ハードインターロックは空圧式または電気式にする必要があり、時間やセンサーの調整は実機で行う必要があります。TiaLink は安全に関する責任を代替するものではありません。

料金はいくらですか？ 月額 ¥99 または年額 ¥999（中国。年間ライセンスでは ¥189 お得です）。複数シート、フローティングライセンス、エアギャップ環境のエンタープライズ導入については個別にお見積もりします。[email protected] までお問い合わせください。

購入してライセンスを取得するにはどうすればよいですか？ 製品ページから購入してください。WeChat Pay での支払い後、アカウント登録やフォームへの入力なしで、ページにダウンロードリンクとセットアップ手順がすぐに表示されます。通常のユーザーとして TiaLink をインストールし、http://localhost:8080/ を開いて、マシンコードと生成された .tlreq リクエストファイルを [email protected] に送信してください。マシンに紐付いた .lic がそのマシン用に発行され、完全オフラインで動作します。

---

リンク

• 製品ページ／購入：https://tia.hubwiz.com/tia-link（WeChat Pay。支払い後にダウンロードリンクが表示されます）
• パブリッシャー：汇智网 — https://www.hubwiz.com/

---

ライセンス

• このリポジトリのドキュメントはCC BY 4.0ライセンスの下で提供されています。詳しくはLICENSEをご覧ください。
• TiaLink ソフトウェア自体（MCP ゲートウェイ／サーバー）は商用ソフトウェアであり、このライセンスの対象外です。すべての権利は留保されています。
• server/ にある stdio ブリッジと、その package.json、manifest.json、Dockerfile は MIT ライセンスです。詳しくはLICENSE-BRIDGEをご覧ください。これは薄いトランスポートアダプターです。フォークしたり、ベンダーとして取り込んだり、独自のエージェントツールに同梱したりできます。実行時には、ライセンスを取得した TiaLink ゲートウェイが引き続き必要です。