LogixDesigner-MCP

MCP server wrapping the Rockwell Automation Logix Designer SDK (Studio 5000) as typed MCP tools, bridged from Windows to Linux via Cloudflare Tunnel.

A Hermes Agent can open ACD files, export to L5K/L5X, read rung logic, enumerate tags and program structure, run verification — all over a typed MCP interface — without ever touching Studio 5000's GUI.

Architecture

Linux (Hermes) ── SSE/HTTPS ──→ Cloudflare Tunnel ──→ Windows
                                                          │
                                              FastMCP ── pythonnet ── Logix Designer SDK
                                              localhost:8765

The Linux side runs mock-based tests; all COM-dependent logic lives on the Windows deployment.

Related MCP server: T-IA Connect (Siemens TIA Portal)

Tools

All tools that can fail return structured SdkError — no raw tracebacks.

Development (Linux)

python -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/pytest tests/ -v

Deployment (Windows)

See deploy/README.md. Requires:

• Windows Server with Studio 5000 v33+

• Logix Designer SDK installed

• Python 3.11+

• Cloudflare Tunnel (cloudflared)

deploy/install.bat        # Create venv, discover SDK, verify
deploy/cloudflared-config.yml   # Tunnel setup guide
deploy/hermes-config.yaml       # Hermes MCP client config

Project status

• Phase 0: Project skeleton

• Phase 1: Pydantic models, abstract SDK interface, mock implementation (Linux tested)

• Phase 2: FastMCP server with 14 tools, error contract, async wrappers

• Phase 3: Windows deployment artifacts

• Phase 4: Real COM interop (RealSdkInterop) — requires Windows