MODX 2 MCP 1.2.0

MODX 2 MCP 1.2.0

Separate MODX 2 distribution of MODX MCP.

• Package: modx2mcp-1.2.0-pl.transport.zip
• Supported platform: MODX Revolution 2.8.x
• MCP contract: 192 actions (81 read-only, 111 mutation)
• Runtime CAS / stale-state protection with get_site_state and atomic preconditions
• ClientConfig CRUD/read support and additional access-policy/resource-group reads
• Shared internal namespace/API/settings remain modxmcp for Runtime compatibility

Important upgrade note

If the previous MODX 2 package with identity modxmcp is installed, fully uninstall it first in Package Manager, then install modx2mcp-1.2.0-pl.transport.zip. Do not keep the old and new package identities installed side by side. The clean uninstall removes old modxmcp.* settings and the API token, so verify the new settings and update the MCP client token after installation if necessary.

Validated on MODX Revolution 2.8.9-pl with PHP 8.2.32. The clean replacement path, transport install/reinstall/uninstall/install cycle, 192-action endpoint, CRUD smoke, read-only smoke, and Runtime CAS handshake passed.

MODX 3 MCP 1.2.0

MODX 3 MCP 1.2.0

Stable MODX 3 distribution of MODX MCP.

• Package: modx3mcp-1.2.0-pl.transport.zip
• Supported platform: MODX Revolution 3.x
• MCP contract: 192 actions (81 read-only, 111 mutation)
• Runtime CAS / stale-state protection with get_site_state and atomic preconditions
• ClientConfig CRUD/read support and additional access-policy/resource-group reads
• Extended safe modular mutations, including Lexicon operations

Validated on MODX Revolution 3.2.4-pl with the full live regression suite.

The MODX 2 distribution is published separately as MODX 2 MCP 1.2.0 under tag modx2-v1.2.0.

MODX MCP 1.1.0

MODX MCP 1.1.0

Первый стабильный релиз общей кодовой базы MODX MCP для MODX Revolution 2.8.x и 3.x.

Платформы

• MODX 2.8.x — modxmcp-1.1.0-pl.transport.zip
• MODX 3.x — modx3mcp-1.1.0-pl.transport.zip
• MCP-клиент на Node.js и публичный контракт из 182 действий одинаковы для обеих платформ.

Устанавливайте только транспортный пакет, соответствующий основной версии MODX.

Главное в 1.1.0

• Единая модульная среда выполнения: 182/182 серверных действия.
• Полностью перенесены 74/74 операции чтения и 108/108 изменяющих операций.
• Различия MODX 2/3 изолированы в платформенных адаптерах и сборочном слое.
• Исправлена передача type в модульные операции создания, изменения и удаления элементов.
• Исправлена работа delete_media_folder на MODX 2.
• MODX 2 fallback приведён к общему контракту для get_user_group и bulk_resources set_template.
• Удалён слабый резервный генератор API-токена в MODX 2 fallback.
• Усилен MODX 2 release pipeline: builder только из CLI, токен не принимается через URL, права 0644/0755, очистка staging, защита от пересборки поверх установленного пакета, сохранение/восстановление modxmcp.* настроек.

Проверено

• GitHub CI: success на релизном commit fa51bbd362cefdc7cca88b240589840017e0ea65.
• MODX Revolution 2.8.9-pl: полный transport release-smoke, 74 read-only parity actions, 46 processor-mutation checks, CRUD всех 7 типов элементов, media 9/9, property sets 5/5, package operations 5/5 и остальные core mutation suites.
• MODX Revolution 3.2.4-pl: полный transport release-smoke и все 14 live parity suites, включая MIGX 3/3 и miniShop2 12/12.
• Совместимость процессоров MODX 3 проверяется CI на 3.2.2-pl, 3.2.4-pl и актуальной ветке 3.x.
• Действующие modxmcp.* настройки и API-токен сохраняются при повторной установке/обновлении.

Глобально разрушительные empty_recycle_bin и regenerate_token не запускались live; они покрыты регистрацией, статическими проверками и проверкой эквивалентности реализации. На чистом MODX 2 сторонние MIGX/miniShop2/VersionX/VirtualPage не установлены, поэтому для них проверен общий контракт отсутствия, а положительные lifecycle-сценарии не заявляются.

SHA-256

9aebe56eb4d06a8cb82ddf7216403edbf2a3d87b0c9e2ca7440e579ddd19db27  modxmcp-1.1.0-pl.transport.zip
0abdee953909d4b7de33c06535052c02768368c4fdb7fde84ea2e8b1ddecc2de  modx3mcp-1.1.0-pl.transport.zip

Исходный commit релиза: fa51bbd362cefdc7cca88b240589840017e0ea65.

MODX3 MCP 1.0.1

MODX3 MCP 1.0.1

Исправляющий релиз для MODX Revolution 3.x.

Что исправлено

• Массовая операция modx_bulk_resources → set_template теперь корректно принимает template: 0. В MODX это штатное значение для ресурса без назначенного шаблона.
• Серверная валидация отличает отсутствующий параметр от значения 0; схема MCP явно разрешает целые значения template >= 0.
• Добавлены regression-проверки, чтобы ошибка с template=0 не вернулась.

Надёжность обновления

Во время release-smoke обнаружен и устранён отдельный пограничный случай transport package: на хостинге с нестандартными правами предыдущая установка могла оставить файлы компонента без права записи владельцу, из-за чего xPDO не мог обновить их. В 1.0.1:

• перед upgrade безопасно восстанавливается owner-write только внутри каталогов MODX3 MCP;
• файлы и каталоги пакета устанавливаются с явными правами 0644 / 0755;
• verifier проверяет фактически развернутую версию модели, а не только наличие файлов;
• endpoint smoke-test поддерживает отдельный URL тестового стенда через MODX_MCP_SMOKE_SITE_URL.

Проверено

• GitHub CI: PHP lint, Node.js syntax, portability/security regression checks и client/server contract;
• совместимость процессоров: MODX Revolution 3.2.2-pl, 3.2.4-pl и актуальная ветка 3.x;
• client/server contract: 182 действия;
• полный transport smoke на MODX Revolution 3.2.4-pl: build → install/upgrade → API/CRUD → reinstall с сохранением настроек → clean uninstall → final install → read-only API smoke;
• реальный dry-run массовой операции подтвердил изменение template: 1 -> 0.

Файлы релиза

• modx3mcp-1.0.1-pl.transport.zip — transport package для MODX Package Manager;
• MODX3-MCP-1.0.1-source.tar.gz — архив исходников из тега v1.0.1;
• SHA256SUMS.txt — SHA-256 для обоих архивов.

SHA-256:

e111ef3a8ddeef6838e06d5727ea887b56cd869539b0b06a976a656c1e742644  MODX3-MCP-1.0.1-source.tar.gz
66e8cb4bf40f2db9c76218a1d8491bf32e9fec3565dd64ca76486ce22dfd7748  modx3mcp-1.0.1-pl.transport.zip

MODX3 MCP 1.0.0

MODX3 MCP 1.0.0

Первый стабильный релиз ветки MODX 3.

Основное

• Native-поддержка MODX Revolution 3.x и namespaced MODX/xPDO API.
• Переносимый MODX transport package modx3mcp-1.0.0-pl.transport.zip.
• Headless/CLI installer с проверками версии, staged deployment и rollback.
• Безопасные значения по умолчанию: HTTPS required, случайный API token через random_bytes(), без скрытого sudo escalation.
• 182 server actions и MCP client с автоматическими safety backup для изменяющих операций.
• Dependency graph, project overview, code search/edit, TV/MIGX/miniShop2, resource/media/package/system tooling.
• Опциональный MODX_MCP_AUDIT_HOOK для внешнего task-level журнала изменений.
• Более точная read/write-классификация: read/preview/dry-run операции не создают лишних mutation lock/audit событий.

Проверено перед релизом

• PHP syntax check: 23 PHP-файла.
• Node syntax check: client/index.js.
• Portability / secure-default regression.
• Client/server contract: 182 actions.
• Processor compatibility: MODX 3.2.2-pl, 3.2.4-pl и ветка 3.x.
• Fresh install на отдельном чистом MODX 3.2.4-pl стенде.
• Runtime/MCP smoke, reinstall с сохранением настроек и clean uninstall.
• Upgrade со старой установки с сохранением существующих настроек и API token.

Файлы

• MODX3-MCP-1.0.0-source.tar.gz — исходный релизный архив.
• modx3mcp-1.0.0-pl.transport.zip — MODX transport package.
• SHA256SUMS.txt — контрольные суммы релизных файлов.

SHA-256

1290e01c05422adb25f6c50671f07a7f37f468df22d3b7aff5cae6daaa9f3cd3  MODX3-MCP-1.0.0-source.tar.gz
9e5c679556700b15776674f2f6d3f63703f71a16870c271cdce3357186f9d465  modx3mcp-1.0.0-pl.transport.zip

Полная история изменений находится в CHANGELOG.md.