# Proxus Industrial MCP Server

> Proxus Industrial MCP Server is an open-source MCP server for manufacturing. Read-only Modbus TCP and OPC UA access to PLCs, meters and drives for AI assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, macOS, Linux, self-hosted, CLI
- **Website:** https://proxus.io/tools/industrial-mcp-server
- **Repository:** https://github.com/proxusiiotplatform/proxus-mcp
- **MCP Registry name:** io.github.proxusiiotplatform/proxus-mcp
- **Categories:** manufacturing
- **Listing updated:** 2026-11-14

## About

Only devices listed in a `proxus-mcp.json` file can be reached, so the assistant cannot scan the plant network. Each device is defined by protocol and address, with OPC UA security mode and policy set per device, and Modbus devices can point to a register map.

The map library is the distinctive part. The binaries include an open collection of 60+ energy meters, power analysers, drives and inverters covering 20,545 registers, so the assistant can call `read_named` for a key like `voltage_l1_n` and get a value with units rather than decoding words by hand. When a number looks wrong, `decode_registers` shows the same registers under every common byte and word order, and `diagnose_connection` steps through name, TCP, protocol, certificates, login and a test read to name the failing layer. `verify_device_map` checks a map against a real device and prepares a report you can submit yourself.

No tool writes values, starts or stops a machine, or changes a controller. It ships as a single binary for Windows, macOS and Linux, or as a Docker image, under Apache-2.0 and currently in beta. It is separate from the paid Proxus platform, which is licensed per gateway.

## Features

- **Read-only by design:** No tool can write values or change a controller.
- **Allow-list of devices:** Only devices named in the config file can be reached.
- **Built-in register maps:** 60+ open maps let the assistant read registers by name with units.
- **Byte-order decoding:** Shows registers decoded under every common byte and word order.
- **Connection diagnosis:** Walks name, TCP, protocol, certificates, login and a test read to find the failure.
- **OPC UA browse and watch:** Browse nodes, read up to 50 variables and watch changes for up to a minute.
- **Map verification:** Checks a map against a live device and prepares a report for the collection.

## Good for

- Ask why a meter reading looks wrong
- Diagnose why a PLC does not answer
- Read energy meter values by name
- Browse an OPC UA server's variables
- Watch how a value moves over a minute
- Check a register map against real hardware

## Install

### Claude Code (Terminal)

```sh
claude mcp add proxus-mcp -- docker run -i --rm ghcr.io/proxusiiotplatform/proxus-mcp:0.1.0-beta.7
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "proxus-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/proxusiiotplatform/proxus-mcp:0.1.0-beta.7"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "proxus-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/proxusiiotplatform/proxus-mcp:0.1.0-beta.7"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "proxus-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/proxusiiotplatform/proxus-mcp:0.1.0-beta.7"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "proxus-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/proxusiiotplatform/proxus-mcp:0.1.0-beta.7"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "proxus-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/proxusiiotplatform/proxus-mcp:0.1.0-beta.7"
      ]
    }
  }
}
```

## Tools

- `list_devices`: Lists configured devices with endpoint, ISA-95 path and connection state.
- `read_address`: Reads raw Modbus registers or bits.
- `watch_address`: Polls a Modbus address for 1 to 60 seconds and summarises changes.
- `decode_registers`: Reads up to 16 registers decoded in every common type and byte order.
- `browse`: Lists the children of an OPC UA node.
- `read_nodes`: Reads up to 50 OPC UA variables with quality and timestamp.
- `watch_nodes`: Watches up to 20 OPC UA variables through a subscription.
- `diagnose_connection`: Steps through connection layers to find why a device cannot be reached.
- `find_device_map`: Searches the register map library by vendor, model or alias.
- `get_device_map`: Returns a map's registers with address, type, byte order, unit and scale.
- `read_named`: Reads registers by key from the device's map and returns values with units.
- `verify_device_map`: Checks a map against the real device and prepares a verification report.

## FAQ

### Can it change values on a machine?

No. The project states nothing can write to a device.

### Which protocols are supported?

Modbus TCP and OPC UA, including Sign and SignAndEncrypt security policies.

### Can it reach the whole network?

No. Only devices listed in the configuration file.

### How do I run it?

Download a binary for Windows, macOS or Linux, or use the Docker image, then point Claude Desktop, Cursor or VS Code at it.

### What licence is it?

Apache-2.0, currently version 0.1.0-beta.7.

### Is Proxus Industrial MCP Server free?

Yes. Proxus Industrial MCP Server is open source, so you can use and self-host it for free.

### How do I add Proxus Industrial MCP Server to Claude Code?

Run this command in your terminal: claude mcp add proxus-mcp -- docker run -i --rm ghcr.io/proxusiiotplatform/proxus-mcp:0.1.0-beta.7

### What are the best alternatives to Proxus Industrial MCP Server?

The closest alternatives to Proxus Industrial MCP Server are Cutlab CNC, ProofPass, 轻排生产排产（MRP-PMC）, The Cable Code and Formada3D 3D Printing.

## Alternatives

- [Cutlab CNC](https://ai-powered.com/mcp/cutlab-cnc): Cutlab CNC is a paid MCP server for manufacturing.
- [ProofPass](https://ai-powered.com/mcp/proofpass): ProofPass is a freemium MCP server for legal and government.
- [轻排生产排产（MRP-PMC）](https://ai-powered.com/mcp/mrp-pmc): 轻排生产排产（MRP-PMC） is a freemium MCP server for manufacturing.
- [The Cable Code](https://ai-powered.com/mcp/the-cable-code): The Cable Code is a freemium MCP server for engineering simulation.
- [Formada3D 3D Printing](https://ai-powered.com/mcp/formada3d-3d-printing): Formada3D 3D Printing is a paid MCP server for design and media.
- [OTDeck](https://ai-powered.com/mcp/otdeck): OTDeck is a freemium MCP server for developer tools.
- [VextCAD](https://ai-powered.com/mcp/vextcad): VextCAD is a freemium MCP server for design and media.
- [Amperis catalogue](https://ai-powered.com/mcp/amperis-catalogue): Amperis catalogue is a free MCP server for manufacturing.

---
Source: https://ai-powered.com/mcp/proxus-industrial-mcp-server
