Codesys-MCP/python_scripting/mcp_codesys_bridge

CODESYS MCP Bridge (Linux)

This MCP server runs on Linux (where Cursor runs) and forwards tool calls to a Windows VM agent that has access to CODESYS.

Tools

• codesys_health
• codesys_submit_job
• codesys_get_job
• create_project
• read_project_inventory
• stage_existing_project
• write_pou
• build_project
• download_to_device

Environment variables

• CODESYS_AGENT_URL (default: http://127.0.0.1:8787)
• CODESYS_AGENT_TOKEN (required)
• CODESYS_AGENT_REQUEST_TIMEOUT_SEC (default: 30)

Run locally

cd mcp_codesys_bridge
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
export CODESYS_AGENT_URL="http://<windows-vm-ip>:8787"
export CODESYS_AGENT_TOKEN="<shared-secret-token>"
python server.py

Cursor MCP config example

{
  "mcpServers": {
    "codesys-bridge": {
      "command": "python",
      "args": ["/absolute/path/to/mcp_codesys_bridge/server.py"],
      "env": {
        "CODESYS_AGENT_URL": "http://<windows-vm-ip>:8787",
        "CODESYS_AGENT_TOKEN": "<shared-secret-token>",
        "CODESYS_AGENT_REQUEST_TIMEOUT_SEC": "30"
      }
    }
  }
}