codesys-mcp

Codesys MCP Setup for VS Code using Johannes's instructions, https://mcpservers.org/servers/johannesPettersson80/codesys-mcp-toolkit

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

Why Codesys MCP for VS Code?

By adding this to VS Code, you can add more scripting functions and build a knowledgebase from the libraries available. This will enable vibe and spec coding using any coding agent available.

Built Functions

Scripting Functions

open_project
create_project
save_project
create_pou
set_pou_code
create_property
create_method
compile_project

MCP Resources

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

Installation Steps

Open VS Code
Hit CTRL+SHIFT+P
Search for MCP: Add Server

Select Install with NPM Package

Type @codesys/mcp-toolkit and hit enter This will take you to a mcp.json file in VS Code Editor
Edit the file to match these contents

{
    "servers": {
        "codesys_local": {
            "command": "codesys-mcp-tool",
            "args": [
                "—codesys-path", // path to your Codesys Executable`
                "...\\CODESYS\\Common\\CODESYS.exe",
                "—codesys-profile", // codesys profile info (exact match)
                "CODESYS V3.5 SP20 Patch 2",
                "—workspace", // your workspace
                "...\\codesys_ws"
            ],
            "type": "stdio"`
        }
    },
    "inputs": []
}

Restart the server

Verify if the tools are loaded

Enable the MCP with the AI chatbot and Enjoy coding!!

Results

https://github.com/user-attachments/assets/9514af74-9890-45d9-b893-43e5301f684f

https://github.com/user-attachments/assets/d6acce4d-f373-4793-8ef4-8b3819bd1b4c

What's next?

I will continue updating this repo with more functions and add knowledgebases for ease.

Knowledgebase: https://content.helpme-codesys.com/en/libs/index.html (most/all chatbots can scrape through and fetch the correct information from within this list) IEC61131: https://www.isa.org/intech-home/2016/september-october/features/programming-standards-improve-automation-controls Best Practices: https://industrialmonitordirect.com/blogs/knowledgebase/plc-programming-standards-and-best-practices-for-maintainable-industrial-code?srsltid=AfmBOoo-eZO-8yFZP1p5q3V92zLdXW1sHeSexP0YCnbPeqW1vhN69COq

Thank you to everyone in the community!

MCP Servers