MMCPMarkets
JC

johannespettersson80/codesys-mcp-toolkit

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

128 stars 38 forks Качество 67 Тренд 16MIT
Repository Install

johannespettersson80/codesys-mcp-toolkit — это кандидат на MCP-сервер, импортированный из https://github.com/johannespettersson80/codesys-mcp-toolkit.

Обзор

johannespettersson80/codesys-mcp-toolkit — это кандидат на MCP-сервер, импортированный из https://github.com/johannespettersson80/codesys-mcp-toolkit.

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP) для программных сред CODESYS V3. Этот набор инструментов обеспечивает бесшовное взаимодействие между клиентами MCP (такими как Claude Desktop) и CODESYS, автоматизируя управление проектами, создание POU, редактирование кода и компиляцию через скриптовый движок CODESYS.

🌟 Особенности

  • Управление проектами

  • Открыть существующие проекты 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, метода или аксесотора свойств.

📋 Предварительные требования

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

@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).

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": {
Открыть полный README на GitHub

Установка

npx -y // Tells npx to install temporarily if not found globally "@codesys/mcp-toolkit // Arguments for the tool MUST come AFTER the package name "--codesys-path C:\\Program Files\\Path\\To\\Your\\CODESYS\\Common\\CODESYS.exe --codesys-profile Your CODESYS Profile Name
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { // ... other servers ... "codesys_local": { "command": "codesys-mcp-tool", // <<< Use the direct command name "args": [ // Pass arguments directly to the tool using flags "--codesys-path", "C:\\Program Files\\Path\\To\\Your\\CODESYS\\Common\\CODESYS.exe", "--codesys-profile", "Your CODESYS Profile Name" // Optional: Add --workspace "/path/to/your/projects" if needed ] } // ... other servers ... } }