Advertise
MCP.so
Sign In

Modbus MCP Server

@ezhuk

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

ezhuk

About Modbus MCP Server

A Model Context Protocol (MCP) server for Modbus.

#mcp#modbus#mcp-server

Modbus MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "modbus-mcp-ezhuk": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Modbus MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Modbus MCP?

A lightweight Model Context Protocol (MCP) server that connects LLM agents to Modbus devices in a secure, standardized way, enabling seamless integration of AI-driven workflows with Building Automation (BAS) and Industrial Control (ICS) systems.

How to use Modbus MCP?

Install via uv add modbus-mcp (or pip install). Embed it in Python code with ModbusMCP().run(transport="http"), or run from the CLI with modbus-mcp or uvx modbus-mcp. Configure a default device via environment variables or a .env file, or define multiple devices in a devices.json file. The server exposes a Streamable HTTP endpoint at http://127.0.0.1:8000/mcp/.

Key features of Modbus MCP

  • Read registers via resource templates and tools
  • Write registers as atomic tool calls
  • Optional authentication via AuthKit provider
  • Interactive prompts for guided Modbus interactions
  • Named device configuration for multi-device setups
  • Docker deployment support

Use cases of Modbus MCP

  • Monitor real-time sensor data from Modbus devices
  • Actuate devices (e.g., valves, boilers) through LLM agents
  • Orchestrate complex automation tasks in BAS/ICS systems
  • Integrate AI agents with Programmable Logic Controllers (PLCs) and Modbus gateways

Frequently asked questions

1

How do I install Modbus MCP?

Use `uv add modbus-mcp` or `pip install modbus-mcp`. For ephemeral environments, run `uvx modbus-mcp`.

2

How do I configure a default Modbus device?

Set environment variables `MODBUS_MCP_MODBUS__HOST`, `MODBUS_MCP_MODBUS__PORT`, and `MODBUS_MCP_MODBUS__UNIT`, or add them to a `.env` file in the working directory.

3

How do I configure multiple devices?

Create a `devices.json` file in the working directory with an array of device objects, each having a `name`, `host`, `port`, and `unit`. Prompts can then refer to devices by name.

4

How do I run the server with Docker?

Run `docker run -d --name modbus-mcp --restart=always -p 8080:8000 --env-file .env ghcr.io/ezhuk/modbus-mcp:latest`.

5

How do I test the server with MCP Inspector?

Run `npx @modelcontextprotocol/inspector` and connect it to `http://127.0.0.1:8000/mcp/` with transport set to `Streamable HTTP`.

Comments

More Other MCP servers

P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Advertise