OPC UA MCP Server

OPC UA MCP サーバー

OPC UA 対応の産業システムに接続し、AI エージェントが運用データをリアルタイムで監視、分析、制御できるようにする MCP サーバーです。

このプロジェクトは、AI 駆動のワークフローと産業オートメーションシステムを橋渡ししたい開発者やエンジニアに最適です。

機能

• OPC UA ノードの読み取り: 産業デバイスからリアルタイムの値を取得します。
• OPC UA ノードへの書き込み: 指定したノードに値を書き込んでデバイスを制御します。
• ノードのブラウズ: すべての OPC UA ノードの一覧表示を要求します
• 複数の OPC UA ノードの読み取り: デバイスから複数のリアルタイムの値を取得します。
• 複数の OPC UA ノードへの書き込み: 複数のノードに値を書き込んでデバイスを制御します。
• シームレスな統合: Claude Desktop などの MCP クライアントと連携し、自然言語での操作を実現します。

ツール

このサーバーは 5 つのツールを公開します:

• read_opcua_node:

  • 説明: 特定の OPC UA ノードの値を読み取ります。
  • パラメータ:
    • node_id (str): OPC UA ノード ID (例: ns=2;i=2)。
  • 戻り値: ノード ID とその値を含む文字列 (例: "Node ns=2;i=2 value: 42")。

• write_opcua_node:

  • 説明: 特定の OPC UA ノードに値を書き込みます。
  • パラメータ:
    • node_id (str): OPC UA ノード ID (例: ns=2;i=3)。
    • value (str): 書き込む値 (ノードの型に基づいて変換されます)。
  • 戻り値: 成功またはエラーのメッセージ (例: "Successfully wrote 100 to node ns=2;i=3")。

• Browse nodes:

  • 説明: 特定の OPC UA ノードの値を読み取ります。

• Read multiple OPC UA Nodes:

  • 説明: 特定の OPC UA ノードの値を読み取ります。

• Write to multiple OPC UA Nodes:

  • 説明: 特定の OPC UA ノードの値を読み取ります。

プロンプトの例

• "What’s the value of node ns=2;i=2?" → 現在の値を返します。
• "Set node ns=2;i=3 to 100." → ノードに 100 を書き込みます。

インストール

前提条件

• Python 3.13 以上
• OPC UA サーバー (例: シミュレーターまたは実際の産業デバイス)

依存関係のインストール

リポジトリをクローンし、必要な Python パッケージをインストールします:

git clone https://github.com/kukapay/opcua-mcp.git
cd opcua-mcp
pip install mcp[cli] opcua cryptography

MCP クライアントの構成

{
 "mcpServers": {
   "opcua-mcp": {
     "command": "python",
     "args": ["path/to/opcua_mcp/main.py"],
     "env": {
        "OPCUA_SERVER_URL": "your-opc-ua-server-url"
     }
   }
 }
}

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。