MMCPMarkets
LH

luke-harriman/codesys-mcp

Developer tools

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

97 stars 22 forks Качество 74 Тренд 5MIT
Repository Install

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

Обзор

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

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

MCP-сервер, который предоставляет API сценариев CODESYS V3.5 в виде 41 инструмента и 3 ресурсов, с интерфейсом CODESYS, открытым для вызовов через файловый IPC-наблюдатель.

В отличие от безголовых оберток, которые порождают новую --noUI Процесс CODESYS по команде, этот сервер запускает CODESYS с видимым пользовательским интерфейсом и маршрутизирует каждый вызов инструмента через скрипт наблюдателя, работающий в том же экземпляре. Изменения появляются в IDE в режиме реального времени, и пользователь может взаимодействовать с CODESYS вместе с автоматизацией на основе ИИ.

Требования

  • Windows Node.js 18+
  • CODESYS V3.5SP19 или SP20 для постоянного режима. SP21+ работает только в безголовом режиме — см. Известные ограничения.

##Установка

Настройка

[[Т1]] (Код Клода):

Для SP21+ установите --mode headless (каждый инструмент вызывает нерест --noUI процесса CODESYS).

CLI

| Флаг | Описание | Дефолт [править править код] [[Т4]] Путь к [[Т5]][[Т6]] или [[Т7]] -f, --codesys-profile $CODESYS_PROFILE CODESYS V3.5 SP21 [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]] [[T]]] [[T]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]] [[T]]] [[T]]] [[T]]] [[T]]] [ -w, --workspace | Рабочее пространство для относительных путей | cwd | -m, --mode ``persistent или headless``persistent

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

README

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

codesys-mcp-persistent

MCP server that exposes the CODESYS V3.5 IDE scripting API as 41 tools and 3 resources, with the CODESYS UI kept open across calls via a file-based IPC watcher.

Unlike headless-only wrappers that spawn a new --noUI CODESYS process per command, this server launches CODESYS with its UI visible and routes every tool call through a watcher script running inside that same instance. Changes appear in the IDE in real time and the user can interact with CODESYS alongside AI-driven automation.

Requirements

  • Windows
  • Node.js 18+
  • CODESYS V3.5 SP19 or SP20 for persistent mode. SP21+ runs only in headless mode — see Known limitations.

Install

git clone 
cd Codesys-MCP
npm install
npm run build
npm link

Configure

.mcp.json (Claude Code):

{
  "mcpServers": {
    "codesys": {
      "command": "codesys-mcp-persistent",
      "args": [
        "--codesys-path", "C:\\Program Files\\CODESYS 3.5.20.0\\CODESYS\\Common\\CODESYS.exe",
        "--codesys-profile", "CODESYS V3.5 SP20",
        "--mode", "persistent"
      ]
    }
  }
}

For SP21+, set --mode headless (each tool call spawns a --noUI CODESYS process).

CLI

Flag Description Default
-p, --codesys-path Path to CODESYS.exe $CODESYS_PATH or C:\Program Files\CODESYS 3.5.21.0\CODESYS\Common\CODESYS.exe
-f, --codesys-profile CODESYS profile name $CODESYS_PROFILE or CODESYS V3.5 SP21
-w, --workspace Workspace for relative paths cwd
-m, --mode persistent or headless persistent
--no-auto-launch Don’t launch CODESYS on startup auto-launch on
--fallback-headless Fall back to headless if persistent launch fails true
--keep-alive Keep CODESYS running after server stops false
--kill-existing-codesys Kill any running CODESYS.exe before launching false
--timeout Default command timeout 60000
--detect List installed CODESYS versions and exit -
--verbose / --debug Logging -

Environment variables:

  • CODESYS_PATH, CODESYS_PROFILE — defaults for the corresponding flags
  • CODESYS_MCP_READY_TIMEOUT_MS — watcher-ready deadline (default 180000)

Tools

Management

Tool Description
launch_codesys Manually launch CODESYS (use with --no-auto-launch). Adopts a live session if one exists
shutdown_codesys Shut down the persistent CODESYS instance
get_codesys_status Report state, PID, execution mode
eval_python [DEV] Execute arbitrary IronPython 2.7 against the live scriptengine. Code must print("SCRIPT_SUCCESS") before exit

Project

Tool Description
open_project Open an existing .project file
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

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

{ "mcpServers": { "codesys": { "command": "codesys-mcp-persistent", "args": [ "--codesys-path", "C:\\Program Files\\CODESYS 3.5.20.0\\CODESYS\\Common\\CODESYS.exe", "--codesys-profile", "CODESYS V3.5 SP20", "--mode", "persistent" ] } } }