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 전송, 또는 제한 없는 셸/파일시스템 접근을 포함하지 않습니다. 그러한 기능은 구체적인 요구 사항이 정당화할 때만 추가되어야 합니다.