Happy slice of mcp pizzaMCP.pizza

codesys-mcp-toolkit

MCP.Pizza Chef: johannesPettersson80

CODESYS is the environment used to program industrial controllers running factory and building equipment. This lets an assistant handle the repetitive parts: opening or creating a project, adding program blocks, editing code, and compiling. The point is fewer trips through menus for routine structural work. It works in Claude Desktop and ChatGPT, installs by pasting a config entry, and drives a CODESYS installation you already have.

Unmaintained · No commits in 16 months.
Coding
Other

Use This MCP server To

Create a new program block without the menus Open an existing controller project Edit code inside a project by describing it Compile a project and see what failed Set up the skeleton of a new project

README

@codesys/mcp-toolkit

npm License Node Version

A Model Context Protocol (MCP) server for CODESYS V3 programming environments. This toolkit enables seamless interaction between MCP clients (like Claude Desktop) and CODESYS, allowing automation of project management, POU creation, code editing, and compilation tasks via the CODESYS Scripting Engine.

🌟 Features

  • Project Management

    • Open existing CODESYS projects (open_project)
    • Create new projects from standard templates (create_project)
    • Save project changes (save_project)

  • POU Management

    • Create Programs, Function Blocks, and Functions (create_pou)
    • Set declaration and implementation code (set_pou_code)
    • Create properties for Function Blocks (create_property)
    • Create methods for Function Blocks (create_method)
    • Compile projects (compile_project)

  • MCP Resources

    • codesys://project/status: Check scripting status and currently open project state.
    • codesys://project/{+project_path}/pou/{+pou_path}/code: Read the declaration and implementation code for a specified POU, Method, or Property accessor.

📋 Prerequisites

  • CODESYS V3: A working CODESYS V3 installation (tested with 3.5 SP21) with the Scripting Engine component enabled during installation.
  • Node.js: Version 18.0.0 or later is recommended.
  • MCP Client: An MCP-enabled application (e.g., Claude Desktop).

(Note: CODESYS uses Python 2.7 internally for its scripting engine, but this toolkit handles the interaction; you do not need to manage Python separately.)

🚀 Installation

The recommended way to install is globally using npm:

npm install -g @codesys/mcp-toolkit

This installs the package globally, making the codesys-mcp-tool command available in your system's terminal PATH.

(Advanced users can also install from source for development - see CONTRIBUTING.md if available).

codesys-mcp-toolkit FAQ

Can I use this to avoid clicking through menus for routine work?
Yes — creating blocks, editing, and compiling can be driven from the assistant.
Do I need CODESYS installed?
Yes, it drives an installation you already have; it does not replace the environment.
Which apps does it work with?
It is documented for Claude Desktop and ChatGPT.
Do I need an account or key?
No separate key beyond your existing CODESYS setup.
How hard is it to set up?
You paste a config entry pointing at your installation, so no coding is required.