open_projectLABSCO SUMMARY
Launch the command directly, not through npx.
The README is unusually specific about one trap: launched via npx inside a host like Claude Desktop, the process inherits a PATH that breaks an internal CODESYS call and you get 'C:\Program' is not recognized the moment you connect. Configure "command": "codesys-mcp-tool" instead. The other rule that saves an afternoon: use forward slashes in the object paths you pass to tools.
What it is
An MCP server for CODESYS V3 industrial programming environments. It drives the CODESYS Scripting Engine, so project management, POU creation, code editing and compilation become tool calls from an assistant rather than clicks in the IDE.
What you get
- Projects:
open_projectfor an existing one,create_projectfrom a standard template,save_project - POUs:
create_poufor Programs, Function Blocks and Functions, andset_pou_codefor declaration and implementation text - Function Block members:
create_propertyandcreate_method compile_project, so the assistant finds out whether its edit builds- Read-only resources:
codesys://project/statusfor scripting state and the currently open project,codesys://project/{+project_path}/structurefor the object tree, andcodesys://project/{+project_path}/pou/{+pou_path}/codefor a POU, method or property accessor's code
Requirements
A CODESYS V3 installation with the Scripting Engine component enabled at install time — the toolkit was tested against 3.5 SP21 — and Node.js 18.0.0 or later. Install globally with npm install -g @codesys/mcp-toolkit, then point your client at the codesys-mcp-tool command and pass --codesys-path to your CODESYS.exe and --codesys-profile to the exact profile name; --workspace sets the root for relative project paths. CODESYS uses Python 2.7 internally for scripting, but the toolkit handles that — you do not manage it.
Setup effort
One command — npm install -g @codesys/mcp-toolkit
USE CASES
01
Adding a Function Block without leaving the assistant
Open the project, create the POU, write its declaration and implementation, then compile to see whether it holds.
02
Reading an unfamiliar project
Fetch the object structure resource, then pull the code of the POUs that matter without opening the IDE.
03
Starting from a template
Create a project from a standard template, populate it, and save.
8 tools
Listed in project docs. Your client may show a different list.
create_projectsave_projectcreate_pouset_pou_codecreate_propertycreate_methodcompile_projectBEFORE YOU INSTALL
What to know first
Tools you get
8 tools named in the project's documentation.
Requires
- npm on PATH
- Node.js 18.0.0 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g @codesys/mcp-toolkitMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"codesys_local": {
"command": "npx",
"args": [
"-y",
"@codesys/mcp-toolkit",
"--codesys-path",
"C:\\Program Files\\Path\\To\\Your\\CODESYS\\Common\\CODESYS.exe",
"--codesys-profile",
"<YOUR_CODESYS_PROFILE_NAME>"
]
}
}
}
