openplc-engineering-mcp
This server provides read-only inspection of OpenPLC Editor projects, though the provided schema exposes only three tools.
Get basic information about the experimental OpenPLC MCP server.
Inspect an OpenPLC project's relevant file structure by supplying a project path.
List the project's programs, function blocks, and functions, including each POU's name, type, language, and path.
All listed schema tools are read-only and idempotent; operations such as editing POUs, validation, compilation, and diagnostics described in the README are not present in the supplied schema.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@openplc-engineering-mcp Show the project structure for my OpenPLC project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
openplc-engineering-mcp
A small experimental Python MCP server that exposes domain-oriented engineering operations for the OpenPLC Editor project.
The project uses the official Model Context Protocol Python SDK and stdio transport. Inspection tools are read-only; compilation is delegated to the authoritative openplc-cli.
Quick start
Requirements: Python 3.12+ and uv.
The release support baseline is Ubuntu 24.04 LTS x86_64 with CPython 3.12.14. The release contract freezes the thirteen-tool interface and defines the evidence required before the release can be declared complete.
git clone https://github.com/allanmarum/openplc-engineering-mcp.git
cd openplc-engineering-mcp
uv sync --locked --python 3.12.14
uv run openplc-engineering-mcpRun the test suite with:
uv run pytestRelated MCP server: gx3-mcp-server
Current tools
get_project_overviewget_project_structurelist_pouslist_datatypesget_execution_configurationget_io_configurationread_pouupdate_poulist_variableslist_global_variablesvalidate_projectcompile_projectget_diagnostics
get_project_overview provides an engineering navigation map; get_project_structure inventories recognized physical artifacts. Use specialized inspection tools for details.
Inspection tools are read-only. update_pou replaces the complete content of one existing Structured Text POU with optimistic-concurrency and atomic-write protection. compile_project is a local write operation that requires openplc-cli on PATH.
Documentation
Read the published documentation for setup, architecture, MCP tools, OpenPLC project behavior, development, scope, and research context.
The source documentation remains in docs/ and docs/index.md is the entry point for agents working directly with the repository.
Compatibility
The frozen OpenPLC Editor/CLI revision is f0bb418b9c3419e573dece4222558570f6a31378, source version 4.2.12. Follow the reproducible validation recipe for its installation, exact compiler dependencies, Runtime v4 compile-only target, and two independent clean-environment checks.
See OpenPLC projects for the current-format boundary. Legacy conversion remains outside the supported scope.
Scope
The current version focuses on project, execution-configuration, physical I/O, POU, data-type, and variable inspection and shallow project validation, plus complete-content replacement of existing Structured Text POUs and compilation delegated to openplc-cli. POU creation/deletion/renaming, writes to other POU languages, data-type modification, resource-configuration modification, deployment, runtime control, variable forcing, authentication, HTTP transport, and generic shell/filesystem tools are not implemented.
See docs/scope.md for the current boundary.
Available Tools
3 toolsget_project_structureBRead-onlyIdempotent
Return the relevant file structure of an OpenPLC Editor project.
Inputs: project_path (required). Returns: name, path, type, files
get_server_infoARead-onlyIdempotent
Return basic information about this experimental OpenPLC MCP server.
Inputs: no named parameters. Returns: object
list_pousBRead-onlyIdempotent
List the programs, function blocks, and functions in an OpenPLC project.
Inputs: project_path (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
get_server_info is clearly distinct as server metadata. get_project_structure and list_pous overlap somewhat since a file structure could include POUs, but the descriptions separate file layout from logical POU listings.
All tool names follow a verb_noun pattern with get_ and list_ prefixes. The mix of get and list is a minor style inconsistency, but the pattern is still predictable and readable.
Three tools is a small but reasonable surface for an experimental read-only server. Each tool serves a distinct purpose, though the inclusion of a generic server_info tool makes the set feel slightly thin.
The server only provides inspection capabilities: server info, project structure, and POU listing. There are no operations for opening, editing, compiling, validating, or managing POU details, which are significant gaps for an engineering-focused server.
Maintenance
Related MCP Connectors
Search and inspect source-pinned agent skills, plugins and tools through a free public MCP.
Read-only MCP server exposing a user ORANO library to their own AI agent.
Read-only discovery of ChatGXT's integration catalog and public MCP capabilities.
Read-only MCP server for the Durable Agent Directory: search and compare agent-infrastructure tools.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI agents to read and understand local Mendix project structure and logic by connecting directly to the .mpr file via MCP. Allows querying microflows, entities, attributes, and modules in read-only mode without requiring cloud access.41ISC
- FlicenseAqualityBmaintenanceProvides read-only analysis of Mitsubishi GX Works3 PLC projects via MCP, enabling device tracing, cross-referencing, ladder inspection, linting, and report generation without modifying source projects.15101 PyPI10-
- FlicenseNot gradedqualityDmaintenanceEnables MCP agents to inspect deployment knowledge extracted from a repository, covering workflows, services, deployments, and images.-
- FlicenseDqualityBmaintenanceProvides read-only, structured access to Yasin ecosystem information (project registry, documentation, GitHub state, diagnostics) through the MCP protocol, enabling AI agents to query without direct repository access.223-