Skip to main content
Glama
openplc-engineering-mcp

openplc-engineering-mcp

by allanmarum

openplc-engineering-mcp

OpenPLC를 위한 도메인 중심의 읽기 전용 엔지니어링 작업을 제공하는 작은 Python MCP 서버입니다.

이 프로젝트는 초기 실험적 구현입니다. 현재 목적은 MCP 호환 에이전트와 OpenPLC Editor 프로젝트 사이에 최소한의 테스트 가능한 통합 경계를 구축하는 것입니다.

아키텍처

MCP Host / LLM Agent
        |
        | MCP
        v
OpenPLC Engineering MCP
        |
        v
OpenPLC

서버는 공식 Model Context Protocol Python SDK와 stdio 전송을 사용합니다. OpenPLC를 수정하지 않으며 일반적인 파일시스템 또는 셸 도구를 노출하지 않습니다.

Related MCP server: gx3-mcp-server

요구 사항

  • Python 3.12+

  • uv

  • Node.js/npm은 MCP Inspector를 사용할 때만 필요합니다 (mcp dev는 npx를 사용합니다)

설치

git clone https://github.com/industrix-com-br/openplc-engineering-mcp.git
cd openplc-engineering-mcp
uv sync

실행

stdio MCP 서버를 시작합니다:

uv run openplc-engineering-mcp

MCP Inspector로 엽니다:

uv run mcp dev src/openplc_engineering_mcp/server.py --with-editable .

테스트

uv run pytest

테스트는 도구 함수를 직접 호출하는 대신 공식 SDK의 인메모리 Client(mcp) 인터페이스를 사용합니다.

현재 도구

  • get_server_info — 서버의 현재 기능을 보고합니다.

  • get_project_structure — OpenPLC Editor 프로젝트의 관련 구조를 반환합니다.

  • list_pous — 현재 OpenPLC Editor 프로젝트 레이아웃을 사용하여 프로그램, 기능 블록, 기능을 나열합니다.

OpenPLC 프로젝트 검사는 현재 Editor 레이아웃을 따릅니다: 프로젝트 루트의 project.json, pous/programs, pous/function-blocks, pous/functions 아래의 POU, 그리고 Editor가 사용하는 관련 장치 및 데이터 타입 위치입니다.

범위

이 버전은 의도적으로 읽기 전용이며 실험적입니다. 프로젝트 수정, 컴파일, 배포, 런타임 제어, 변수 강제 설정, 인증, HTTP 전송, 또는 제한 없는 셸/파일시스템 접근을 포함하지 않습니다. 그러한 기능은 구체적인 요구 사항이 정당화할 때만 추가되어야 합니다.

Available Tools

3 tools
get_project_structureB
Read-onlyIdempotent

Return the relevant file structure of an OpenPLC Editor project.

Inputs: project_path (required). Returns: name, path, type, files

get_server_infoA
Read-onlyIdempotent

Return basic information about this experimental OpenPLC MCP server.

Inputs: no named parameters. Returns: object

list_pousB
Read-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

    B3.3/5.0

    Scored across 3 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness2/5

    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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      4
      1
      ISC
    • F
      license
      A
      quality
      B
      maintenance
      Provides 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.
      15
      101 PyPI
      10
      -
    • F
      license
      D
      quality
      B
      maintenance
      Provides 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.
      22
      3
      -