Modbus MCP 服务器

MCP 服务器可标准化和情境化 Modbus 数据，从而实现 AI 代理与工业物联网系统的无缝集成。

特征

• 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. 安装 ：

   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文件或 Shell 环境中设置这些变量。

环境变量

示例.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 许可证。详情请参阅许可证。