modbus-mcp

An MCP server that standardizes and contextualizes Modbus data, enabling seamless integration of AI agents with industrial IoT systems.

• Modbus Tools:
• Read/write holding registers (read_register, write_register).
• Read/write coils (read_coils, write_coil).
• Read input registers (read_input_registers).
• Read multiple holding registers (read_multiple_holding_registers).
• Prompt: Analyze Modbus register values with a customizable prompt (analyze_register).
• Flexible Connections: Supports Modbus over TCP, UDP, or serial, configured via environment variables.

• Python: 3.10
• uv for dependency and virtual environment management.

1. Install `uv`:

   curl -LsSf https://astral.sh/uv/install.sh | sh

1. Clone the Repository:

   git clone https://github.com/kukapay/modbus-mcp.git
   cd modbus-mcp

1. Install Dependencies:

   uv sync

The server connects to a Modbus device using parameters specified via environment variables. Set these variables in a .env file or your shell environment.

| Variable | Description | Default | Required | |------------------------- |--------------------------------------------------|----------------------|----------| | MODBUS_TYPE | Connection type: tcp, udp, or serial | tcp | Yes | | MODBUS_HOST | Host address for TCP/UDP | 127.0.0.1 | For TCP/UDP | | MODBUS_PORT | Port for TCP/UDP | 502