PLCGateway

PLCGateway MCP

PLC、CNC マシン、SCADA 向けの MCP サーバーです。 AI アシスタントに稼働中のマシンデータ、アラーム、履歴、OEE について質問したり、 ご利用のネットワーク上でデバイス、タグ、画面、レポートを追加したりできます。

PLCGateway は、PLC ゲートウェイおよび SCADA ソフトウェアです。PLC、CNC マシン、コントローラー （Siemens S7、Modbus、Mitsubishi、Omron、Allen-Bradley、FANUC、OPC UA など）に接続し、そのデータを OPC UA、MQTT、 Modbus TCP、REST 経由で共有します。すべての PLCGateway 製品には MCP サーバーが組み込まれています。このパッケージは小さな stdio ブリッジです。 サーバーをコマンドとして起動する MCP クライアント（Claude Desktop、Claude Code、Cursor、Cline、Windsurf、…）がこれを実行し、 ご利用のネットワーク上にある お使いの PLCGateway へすべてを転送します。

AI client ──stdio──▶ @plcgateway/mcp ──HTTP (your network)──▶ PLCGateway on your premises ──▶ PLCs & machines

• PLCGateway はお客様の施設内で動作します。ブリッジは指定されたアドレスとのみ通信し、データを収集したり、ほかの場所へ送信したりすることはありません。
• アシスタントは、指定したトークンの権限で動作します。権限は人に適用されるものと同じです。

質問できること

• 「過去 2 時間に、ライン 3 でアラームはいくつ発生しましたか？」
• 「今日の充填機の OEE はいくつで、どこで最も時間を失いましたか？」
• 「過去 24 時間のタンク水位の傾向を要約してください。」
• 「ライン 1 のシフトごとの生産量とエネルギーを示すレポートダッシュボードを作成してください。」 (確認用のドラフト)
• 「192.168.1.40 の Modbus TCP メーターを『Compressor 2 energy meter』として追加してください。」 (MCP 設定トークンが必要です)

ツール

ツールは接続先の PLCGateway から提供されるため、リストはエディションとトークンの権限に応じて変わります。

グループ	ツール
コンテキスト	get_site_context, system_status, help, list_protocols
データ	list_devices, list_tags, read_tags, query_history, write_tag
アラーム	active_alarms, alarm_history, alarm_stats, acknowledge_alarm, list_alarm_definitions
生産	calculate_oee, get_production_kpis, list_production_assets, list_batches, list_production_batches, set_batch_result
画面とレポート	list_screens, get_screen, list_symbols, create_screen_draft, create_dashboard_draft, generate_report
設定（管理者）	set_site_profile, test_device, create_device, update_device, create_tags, update_tags, define_production_asset, define_products, OPC UA 証明書アクション

詳細な説明：https://plcgateway.com/ai-mcp

対応デバイスとプロトコル

すべてのライセンスで全ドライバーを利用でき、デバイス数やタグ数の上限はありません。

Siemens S7 · Modbus TCP/RTU · Mitsubishi MC · Omron FINS · Allen-Bradley EtherNet/IP · Beckhoff ADS · FANUC FOCAS · OPC UA and DA · IEC 60870-5-104 · IEC 61850 · DNP3 · BACnet

データは OPC UA サーバー、MQTT、Modbus TCP サーバー、REST API 経由で送信されます。詳細：https://plcgateway.com/protocols

安全性

• お客様の施設内で動作します。 PLCGateway が独自にクラウドへデータを送信することはありません。ツールの結果は、接続先のアシスタントにのみ送信されます。 セルフホスト型モデルを使用する場合、データはネットワーク内にとどまります。
• 人と同じ権限です。 ビューアー、オペレーター、管理者の権限はアシスタントにも適用されます。値を書き込むには オペレーター権限が必要です。設定には、管理者セッション、ローカル接続、または設定トークンが必要です。
• 稼働中の変更ではなく、ドラフトです。 アシスタントが作成する画面やダッシュボードは、人が確認するドラフトです。
• 監査証跡。 書き込みはすべてユーザー名とともに記録されます。

要件

• MCP が有効になっており、AI クライアントを実行しているコンピューターからアクセスできる PLCGateway SCADA または Connect
• API トークン：PLCGateway → Settings → API token（オペレーター権限：読み取り、書き込み、アラーム確認）
• Node.js 18.17 以降

セットアップ作業（デバイスやタグの追加）を行う場合は、Settings でMCP 設定トークンを作成し、作業が終わったら無効にしてください。

セットアップ

Claude Desktop、Cursor、Cline、その他の stdio クライアント

{
  "mcpServers": {
    "plcgateway": {
      "command": "npx",
      "args": ["-y", "@plcgateway/mcp"],
      "env": {
        "PLCGATEWAY_URL": "http://192.168.1.50:8080",
        "PLCGATEWAY_TOKEN": "<your API token>"
      }
    }
  }
}

Claude Code

claude mcp add --transport stdio \
  --env PLCGATEWAY_URL=http://192.168.1.50:8080 \
  --env PLCGATEWAY_TOKEN=<your API token> \
  plcgateway -- npx -y @plcgateway/mcp

HTTP MCP を直接サポートするクライアント

このパッケージは不要です。PLCGateway に直接接続してください。

{ "mcpServers": { "plcgateway": { "type": "http", "url": "http://192.168.1.50:8080/mcp",
                                   "headers": { "Authorization": "Bearer <your API token>" } } } }

PLCGateway が動作するコンピューター上

plcgateway-scada --mcp-stdio（または plcgateway-connect --mcp-stdio）をコマンドとして直接追加できます。

設定

変数	フラグ	説明
PLCGATEWAY_URL	--url	PLCGateway のアドレス。例：http://192.168.1.50:8080（/mcp がない場合は追加されます）
PLCGATEWAY_TOKEN	--token	API トークンまたは MCP 設定トークン。環境変数の使用を推奨します。
PLCGATEWAY_TIMEOUT	--timeout	リクエストのタイムアウト時間（秒、既定値は 120）

独自の認証局を使用した HTTPS の場合は、NODE_EXTRA_CA_CERTS=/path/to/ca.pem を設定してください。

トラブルシューティング

ブリッジのログは stderr に出力されます（クライアントの MCP ログで確認できます）。

クライアントの接続時に PLCGateway に到達できない場合、ブリッジは単一のツール connection_status を備えたオフラインモードで動作し続けます。アシスタントに「なぜ PLCGateway に接続されていないのですか？」と尋ねると、理由が報告されます。ブリッジは自動的に再試行し、PLCGateway から応答があると、プラント用のツールが表示されます。

メッセージ	確認する項目
PLCGateway not reachable	アドレスとポート、ファイアウォール、PLCGateway が動作しているか
HTTP 401/403	トークン（Settings → API token）。トークンを再生成すると、古いトークンは置き換えられます
HTTP 404	PLCGateway の設定で MCP が無効になっているか、URL が別の場所を指しています

PLCGateway の入手

• すべての製品とモジュールを30 日間試用できます。ライセンスは不要です：https://plcgateway.com/contact
• 価格：コンピューターごとの買い切りライセンス。すべてのエディションに MCP サーバーが含まれています：https://plcgateway.com/pricing

リンク

• 製品：https://plcgateway.com
• AI と MCP：https://plcgateway.com/ai-mcp
• 対応プロトコル：https://plcgateway.com/protocols
• npm：https://www.npmjs.com/package/@plcgateway/mcp
• ブリッジに関する問題：https://github.com/CybriantOps/plcgateway-mcp/issues

ライセンス

このリポジトリのブリッジは MIT ライセンスです。PLCGateway 自体はプロプライエタリソフトウェアであり、別途ライセンスが必要です。