@codesys/mcp-toolkit

What is @codesys/mcp-toolkit?

A Model Context Protocol (MCP) server for CODESYS V3 programming environments. It enables MCP clients (like Claude Desktop) to automate project management, POU creation, code editing, and compilation tasks via the CODESYS Scripting Engine.

How to use @codesys/mcp-toolkit?

Install globally with npm install -g @codesys/mcp-toolkit. Configure your MCP client to run the codesys-mcp-tool command directly, passing the required --codesys-path and --codesys-profile arguments. Restart the client to apply the settings.

Key features of @codesys/mcp-toolkit

• Open, create, and save CODESYS projects.
• Create Programs, Function Blocks, and Functions.
• Set declaration and implementation code for POUs.
• Create properties and methods for Function Blocks.
• Compile projects.
• Read project status, structure, and POU code via MCP resources.

Use cases of @codesys/mcp-toolkit

• Automate opening and modifying CODESYS projects from an MCP client.
• Create and edit POU code programmatically without the CODESYS IDE.
• Compile projects and retrieve compilation results.
• Inspect project structure and POU content remotely.

FAQ from @codesys/mcp-toolkit

What are the prerequisites for @codesys/mcp-toolkit?

A working CODESYS V3 installation (tested with 3.5 SP21) with the Scripting Engine component enabled, Node.js 18+, and an MCP-enabled application.

How do I configure the CODESYS path and profile?

Pass --codesys-path <path> and --codesys-profile <profile> when running codesys-mcp-tool in your MCP client configuration. Alternatively, set the CODESYS_PATH and CODESYS_PROFILE environment variables, but the command-line arguments are recommended.

Why does the tool fail with a 'C:\Program' error?

This error occurs when launched via npx