modbus-mcp

Modbus MCP サーバー

Modbus データを標準化およびコンテキスト化し、AI エージェントと産業用 IoT システムのシームレスな統合を可能にする MCP サーバー。

特徴

• Modbus ツール:
  • 読み取り/書き込み保持レジスタ ( read_register 、 write_register )。
  • 読み取り/書き込みコイル ( read_coils 、 write_coil )。
  • 入力レジスタを読み取ります ( read_input_registers )。
  • 複数の保持レジスタを読み取ります ( read_multiple_holding_registers )。
• プロンプト: カスタマイズ可能なプロンプト ( analyze_register ) を使用して Modbus レジスタ値を分析します。
• 柔軟な接続: 環境変数を介して構成された TCP、UDP、またはシリアル経由の Modbus をサポートします。

要件

• Python : 3.10
• 依存関係と仮想環境の管理のためのuv 。

インストール

1. uvをインストールします:
   curl -LsSf https://astral.sh/uv/install.sh | sh
2. リポジトリのクローンを作成します:
   git clone https://github.com/kukapay/modbus-mcp.git cd modbus-mcp
3. 依存関係をインストール:
   uv sync

構成

サーバーは、環境変数で指定されたパラメータを使用してModbusデバイスに接続します。これらの変数は、 .envファイルまたはシェル環境で設定してください。

環境変数

.envファイルの例

TCPの場合:

シリアルの場合:

使用法

Claude Desktop へのインストール

設定ファイル:

ツールの使用

注：自然言語サポートは、クライアントがプロンプトを解析し、ツールにマッピングする能力に依存します。MCPインスペクターでは構造化されたJSONが必要ですが、以下の例は会話型入力がどのように翻訳されるかを示しています。

1. 保有台帳の読み取り:
   • プロンプト：
     Please read the value of Modbus holding register 0.
   • MCP インスペクター JSON :
     { "tool": "read_register", "parameters": {"address": 0} }
   • 予想される出力: Value: <register_value>
2. 保留レジスタへの書き込み:
   • プロンプト：
     Set Modbus holding register 10 to the value 100.
   • MCP インスペクター JSON :
     { "tool": "write_register", "parameters": {"address": 10, "value": 100} }
   • 期待される出力: Successfully wrote 100 to register 10
3. 読み取りコイル:
   • プロンプト：
     Check the status of the first 5 Modbus coils starting at address 0.
   • MCP インスペクター JSON :
     { "tool": "read_coils", "parameters": {"address": 0, "count": 5} }
   • 予想される出力： Coils 0 to 4: [False, False, False, False, False]
4. コイルに書き込む:
   • プロンプト：
     Turn on Modbus coil 5.
   • MCP インスペクター JSON :
     { "tool": "write_coil", "parameters": {"address": 5, "value": true} }
   • 期待される出力: Successfully wrote True to coil 5
5. 入力レジスタの読み取り:
   • プロンプト：
     Read the values of 3 Modbus input registers starting from address 2.
   • MCP インスペクター JSON :
     { "tool": "read_input_registers", "parameters": {"address": 2, "count": 3} }
   • 予想される出力: Input Registers 2 to 4: [<value1>, <value2>, <value3>]
6. 複数の保持レジスタの読み取り:
   • プロンプト：
     Get the values of Modbus holding registers 0 through 2.
   • MCP インスペクター JSON :
     { "tool": "read_multiple_holding_registers", "parameters": {"address": 0, "count": 3} }
   • 予想される出力: Holding Registers 0 to 2: [<value1>, <value2>, <value3>]

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はライセンスをご覧ください。