CODESYS V3 프로그래밍 환경을 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 툴킷은 MCP 클라이언트(예: Claude Desktop)와 CODESYS 간의 원활한 상호작용을 가능하게 하여, CODESYS 스크립팅 엔진을 통한 프로젝트 관리, POU 생성, 코드 편집 및 컴파일 작업을 자동화할 수 있게 합니다.

🌟 특징

• 프로젝트 관리

• 기존 CODESYS 프로젝트 공개 (open_project)

• 표준 템플릿(create_project)에서 새 프로젝트 생성

• 프로젝트 변경 사항 저장 ([save_project)

• **POU 경영

• 프로그램, 기능 블록 및 함수 생성 (create_pou)

• 선언 및 구현 코드 세트 (set_pou_code)

• 기능 블록(create_property)에 대한 속성 생성

• 기능 블록(create_method)에 대한 메서드 생성

• 컴파일 프로젝트 (compile_project)

• MCP 리소스

• codesys://project/status: 스크립팅 상태와 현재 열린 프로젝트 상태를 점검합니다.

• codesys://project/{+project_path}/structure: 지정된 프로젝트의 객체 구조를 검색합니다.

• codesys://project/{+project_path}/pou/{+pou_path}/code: 지정된 POU, 메서드 또는 속성 accessor에 대한 선언 및 구현 코드를 읽습니다.

📋 선수 조건

@codesys/mcp-toolkit

A Model Context Protocol (MCP) server for CODESYS V3 programming environments. This toolkit enables seamless interaction between MCP clients (like Claude Desktop) and CODESYS, allowing automation of project management, POU creation, code editing, and compilation tasks via the CODESYS Scripting Engine.

🌟 Features

• Project Management

  • Open existing CODESYS projects (open_project)
  • Create new projects from standard templates (create_project)
  • Save project changes (save_project)

• POU Management

  • Create Programs, Function Blocks, and Functions (create_pou)
  • Set declaration and implementation code (set_pou_code)
  • Create properties for Function Blocks (create_property)
  • Create methods for Function Blocks (create_method)
  • Compile projects (compile_project)

• MCP Resources

  • codesys://project/status: Check scripting status and currently open project state.
  • codesys://project/{+project_path}/structure: Retrieve the object structure of a specified project.
  • codesys://project/{+project_path}/pou/{+pou_path}/code: Read the declaration and implementation code for a specified POU, Method, or Property accessor.

📋 Prerequisites

• CODESYS V3: A working CODESYS V3 installation (tested with 3.5 SP21) with the Scripting Engine component enabled during installation.
• Node.js: Version 18.0.0 or later is recommended.
• MCP Client: An MCP-enabled application (e.g., Claude Desktop).

(Note: CODESYS uses Python 2.7 internally for its scripting engine, but this toolkit handles the interaction; you do not need to manage Python separately.)

🚀 Installation

The recommended way to install is globally using npm:

npm install -g @codesys/mcp-toolkit

This installs the package globally, making the codesys-mcp-tool command available in your system’s terminal PATH.

(Advanced users can also install from source for development - see CONTRIBUTING.md if available).

🔧 Configuration (IMPORTANT!)

This toolkit needs to know where your CODESYS installation is and which profile to use. Configuration is typically done within your MCP Client application (like Claude Desktop).

Recommended Configuration Method (Direct Command)

Due to potential environment variable issues (especially with PATH) when launching Node.js tools via wrappers like npx within certain host applications (e.g., Claude Desktop), it is strongly recommended to configure your MCP client to run the installed command codesys-mcp-tool directly.

Example for Claude Desktop (settings.json -> mcpServers):

{
  "mcpServers": {
    // ... other servers ...
    "codesys_local": {