multi-plc-agent

One MCP server that lets an AI agent write ladder logic in several PLC engineering tools: Mitsubishi GX Works2, Siemens TIA Portal and Omron CX-Programmer.

multi-plc-agent does not drive any PLC software by itself. It starts one existing MCP server per tool, gives every tool a vendor prefix (mitsubishi_, siemens_, omron_) and exposes them as one server. Each backend keeps its own approval flow and safety checks. The router adds one shared rule on top: tools that act on a live PLC or delete project content are not exposed.

Supported software

"Verified on" lists only what was actually run. Other CPUs and versions may work, but they have not been tested.

Related MCP server: x402-industrial-mcp

Install (Windows)

Install each backend you need by following its own README, then:

git clone https://github.com/Wayan123/multi-plc-agent.git
cd multi-plc-agent
py -3 -m pip install .
copy config.example.json config.json

The router has no dependencies outside the Python standard library (3.10+).

Edit config.json, or set the variables it refers to:

Set "enabled": false on any backend you don't use. Check that every backend starts:

multi-plc-agent --config config.json --check

The command exits with 0 only when every enabled backend reports running.

Connect an MCP client

{
  "mcpServers": {
    "multi-plc": {
      "command": "multi-plc-agent",
      "args": ["--config", "C:\\path\\to\\config.json"]
    }
  }
}

Ask the agent to call list_plc_backends first. It returns each backend's status, server identity, exposed tool count and the tools that were withheld.

What is not exposed

To expose a withheld tool on one backend, add "allow": ["ToolName"] to it. To withhold more tools, use "deny".

Per-backend notes

• GX Works2. Native compile and live ST/FBD sessions still require 1.635.0.1. On 1.580, only Ladder CSV import and export are enabled. Save the project in GX Works2 yourself, because the tool won't save an unnamed project. The 1.580 support is proposed upstream in Arienax/gxworks-agent#11.

• TIA Portal. Add your Windows user to the Siemens TIA Openness group yourself and sign in again before the first start. Otherwise the server tries to do it through UAC and exits if that fails. TIA Portal asks for Openness access on every connect unless you choose "Yes to all".

• CX-Programmer. The backend edits one project file, set by --project. Close the project in CX-Programmer before the agent commits. If it was open, close it without saving and reopen it. The backend was written for CP1E. Its address and instruction checks do not cover CP1L, CP1H, CJ or CS.

Safety

Generated ladder logic is a draft. Review it and test it in a simulator (GX Simulator2, PLCSIM, CX-Simulator) before it reaches equipment. Emergency stop, guarding, two-hand control and overload protection must be implemented by independent safety hardware, not by AI-generated logic.

Development

py -3 -m pip install pytest
py -3 -m pytest tests -q

The tests start fake stdio backends. They need no PLC software.

License

Apache-2.0, see LICENSE. Backends are separate projects under their own licenses, see NOTICE. This repository does not include or redistribute their code.