Servidor Modbus MCP

Un servidor MCP que estandariza y contextualiza los datos Modbus, lo que permite una integración perfecta de los agentes de IA con los sistemas de IoT industriales.

Características

• Herramientas Modbus :

  • Leer/escribir registros de retención ( read_register , write_register ).

  • Bobinas de lectura/escritura ( read_coils , write_coil ).

  • Leer registros de entrada ( read_input_registers ).

  • Leer múltiples registros de retención ( read_multiple_holding_registers ).

• Aviso : Analice los valores de registro Modbus con un aviso personalizable ( analyze_register ).

• Conexiones flexibles : admite Modbus sobre TCP, UDP o serie, configurado a través de variables de entorno.

Requisitos

• Python : 3.10

• uv para gestión de dependencias y entornos virtuales.

Instalación

1. Instalar :

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

2. Clonar el repositorio :

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

3. Instalar dependencias :

   uv sync

Configuración

El servidor se conecta a un dispositivo Modbus mediante parámetros especificados mediante variables de entorno. Configure estas variables en un archivo .env o en su entorno de shell.

Variables de entorno

Ejemplo de archivo .env

Para TCP:

Para serie:

Uso

Instalación para Claude Desktop

El archivo de configuración:

Uso de herramientas

Nota : La compatibilidad con lenguaje natural depende de la capacidad del cliente para analizar y asignar indicaciones a las herramientas. El Inspector MCP requiere JSON estructurado, pero los ejemplos a continuación muestran cómo se traducen las entradas conversacionales.

1. Leer un registro de tenencia :

   • Inmediato :

     Please read the value of Modbus holding register 0.

   • Inspector JSON de MCP :

     { "tool": "read_register", "parameters": {"address": 0} }

   • Resultado esperado : Value: <register_value>

2. Escribir en un registro de tenencia :

   • Inmediato :

     Set Modbus holding register 10 to the value 100.

   • Inspector JSON de MCP :

     { "tool": "write_register", "parameters": {"address": 10, "value": 100} }

   • Resultado esperado : Successfully wrote 100 to register 10

3. Bobinas de lectura :

   • Inmediato :

     Check the status of the first 5 Modbus coils starting at address 0.

   • Inspector JSON de MCP :

     { "tool": "read_coils", "parameters": {"address": 0, "count": 5} }

   • Salida esperada : Coils 0 to 4: [False, False, False, False, False]

4. Escribir en una bobina :

   • Inmediato :

     Turn on Modbus coil 5.

   • Inspector JSON de MCP :

     { "tool": "write_coil", "parameters": {"address": 5, "value": true} }

   • Resultado esperado : Successfully wrote True to coil 5

5. Leer registros de entrada :

   • Inmediato :

     Read the values of 3 Modbus input registers starting from address 2.

   • Inspector JSON de MCP :

     { "tool": "read_input_registers", "parameters": {"address": 2, "count": 3} }

   • Salida esperada : Input Registers 2 to 4: [<value1>, <value2>, <value3>]

6. Leer varios registros de retención :

   • Inmediato :

     Get the values of Modbus holding registers 0 through 2.

   • Inspector JSON de MCP :

     { "tool": "read_multiple_holding_registers", "parameters": {"address": 0, "count": 3} }

   • Salida esperada : Holding Registers 0 to 2: [<value1>, <value2>, <value3>]

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte la LICENCIA para más detalles.