Бесплатно
Загрузите дополнение из админки вашего сайта.
Как загрузить?
Как загрузить?
Автор дополнения
Александр Палочкин
Пакетов
4 Закачек
18 
Внимание, этот компонент требует PHP
8.1
или выше!
Внимание, этот компонент требует MODX 3 или выше.
MODX3MCP — компонент для подключения внешних ИИ-агентов к MODX Revolution 3.x через протокол Model Context Protocol.
Важно: MODX3MCP не является готовым ИИ-агентом и не добавляет искусственный интеллект в MODX сам по себе.
После установки компонента в панели управления не появится чат, которому можно сразу поручать работу с сайтом. Компонент решает другую задачу: он создаёт специальный интерфейс между MODX и внешней агентной системой.
То есть MODX3MCP — это одна из частей более крупного контура:
Пользовательский интерфейс, сам ИИ-агент и организация его работы находятся за пределами компонента. Например, интерфейсом для постановки задач может быть Telegram-бот, через который с одним проектом одновременно работает несколько участников команды.
Такая архитектура позволяет не встраивать конкретный ИИ-сервис непосредственно в MODX и не привязывать компонент к одной модели, одному чату или одному способу управления.
MODX3MCP предоставляет внешнему агенту специализированный набор инструментов для работы с MODX.
Вместо произвольного доступа к базе данных или файловой системе агент получает возможность работать непосредственно с сущностями CMS:
В текущей версии доступно 192 публичных инструмента MCP: 81 операция чтения и 111 изменяющих операций.
В состав компонента входит собственная административная панель для настройки подключения и управления возможностями MCP.
Панель имеет адаптивный двухколоночный интерфейс. В ней можно посмотреть адрес API, скопировать его для подключения внешнего клиента, настроить параметры компонента и включить или отключить отдельные группы инструментов.
API-токен не отображается открыто при загрузке страницы. Администратор с необходимыми правами может отдельно посмотреть или скопировать его. Перевыпуск токена выполняется только по явному запросу с предупреждением о необходимости обновить подключения существующих клиентов.
Одно из основных отличий MODX3MCP от обычного доступа к серверу — понимание структуры MODX.
Для агента ресурс остаётся ресурсом, шаблон — шаблоном, чанк — чанком, TV — TV-полем.
Это позволяет не просто изменять данные, а предварительно исследовать проект: искать связанные элементы, определять места использования и оценивать возможные последствия изменения.
В состав компонента входит граф зависимостей, который показывает связи между элементами MODX и помогает обнаруживать:
Интерфейс графа зависимостей адаптирован для работы непосредственно в менеджере MODX. Предусмотрены фильтры, масштабирование и прокрутка рабочей области, что упрощает исследование структуры крупных проектов.
MODX3MCP рассчитан не только на чтение данных, но и на работу с реальными проектами, поэтому значительная часть функциональности связана с контролем изменяющих операций.
Начиная с версии 1.2.0 компонент поддерживает защиту от записи по устаревшему состоянию сайта. Агент может получить текущую ревизию проекта через
Если при выполнении защищённой операции обнаруживается, что данные уже изменены другим агентом или процессом, операция отклоняется с ошибкой
В текущей версии усилена защита изменений TV-полей. Механизм CAS v2 позволяет проверять ревизию сайта и исходные значения изменяемых TV под общей блокировкой, а несколько значений сохранять в одной транзакции. Проверка исходного состояния также предусмотрена при изменении отдельных свойств элементов.
Важно: защита от конкурентных изменений действует при использовании соответствующих предварительных условий. Прямые обращения к API без этих условий не гарантируют защиту от перезаписи данных, изменённых другим агентом.
В компоненте предусмотрены:
При использовании штатного MCP-клиента дополнительно доступны защитные резервные копии перед рядом изменяющих операций, блокировка параллельных записей в рамках одного проекта и передача сведений о выполненных изменениях во внешнюю систему аудита.
При этом MODX3MCP не гарантирует правильность решений самого ИИ-агента. Агент может неправильно понять поставленную задачу или выбрать неподходящий способ её выполнения.
Действующий API-токен предоставляет широкие полномочия для работы с MODX. Отключение отдельных групп инструментов не является полноценным разграничением прав между внешними пользователями.
Поэтому права и возможности агента должны соответствовать конкретному проекту и задачам, которые ему разрешено выполнять.
Эта версия компонента предназначена для MODX Revolution 3.x.
Установка MODX3MCP — это только установка MODX-части системы.
После установки необходимо настроить API, обеспечить безопасное хранение токена и подключить внешний MCP-клиент. При новой установке API компонента по умолчанию выключен и требует явного включения администратором.
Для получения полноценного рабочего агента необходимо отдельно организовать внешний контур: подключить ИИ-агента, настроить его взаимодействие с MODX3MCP и определить правила его работы.
При необходимости можно дополнительно использовать Telegram-бота как общий интерфейс постановки задач. Это удобно, например, когда над одним проектом работают несколько человек.
Конкретная конфигурация зависит от того, какой ИИ, какой интерфейс и какой уровень автоматизации необходим пользователю.
Настройка внешнего контура обычно требует участия специалиста: подключение ИИ-агента, настройка взаимодействия с MODX3MCP, прав доступа и правил работы выполняются с учётом особенностей конкретного проекта.
MODX3MCP распространяется бесплатно по лицензии MIT.
Исходный код проекта и готовые релизы находятся в открытом репозитории GitHub:
https://github.com/rumata-estor/modx3-mcp
Важно: MODX3MCP не является готовым ИИ-агентом и не добавляет искусственный интеллект в MODX сам по себе.
После установки компонента в панели управления не появится чат, которому можно сразу поручать работу с сайтом. Компонент решает другую задачу: он создаёт специальный интерфейс между MODX и внешней агентной системой.
То есть MODX3MCP — это одна из частей более крупного контура:
Пользователь → ИИ-агент → MODX3MCP → MODXПользовательский интерфейс, сам ИИ-агент и организация его работы находятся за пределами компонента. Например, интерфейсом для постановки задач может быть Telegram-бот, через который с одним проектом одновременно работает несколько участников команды.
Такая архитектура позволяет не встраивать конкретный ИИ-сервис непосредственно в MODX и не привязывать компонент к одной модели, одному чату или одному способу управления.
Что делает MODX3MCP
MODX3MCP предоставляет внешнему агенту специализированный набор инструментов для работы с MODX.
Вместо произвольного доступа к базе данных или файловой системе агент получает возможность работать непосредственно с сущностями CMS:
- ресурсами и структурой сайта;
- шаблонами;
- чанками;
- сниппетами;
- плагинами;
- TV-полями и их значениями;
- системными настройками;
- категориями;
- контекстами;
- пользователями и группами;
- политиками доступа и шаблонами политик;
- группами ресурсов и их составом;
- источниками файлов и медиа;
- пакетами и установленными дополнениями;
- наборами свойств;
- настройками ClientConfig;
- MIGX;
- miniShop2;
- VersionX;
- VirtualPage.
В текущей версии доступно 192 публичных инструмента MCP: 81 операция чтения и 111 изменяющих операций.
Панель управления MODX3MCP
В состав компонента входит собственная административная панель для настройки подключения и управления возможностями MCP.
Панель имеет адаптивный двухколоночный интерфейс. В ней можно посмотреть адрес API, скопировать его для подключения внешнего клиента, настроить параметры компонента и включить или отключить отдельные группы инструментов.
API-токен не отображается открыто при загрузке страницы. Администратор с необходимыми правами может отдельно посмотреть или скопировать его. Перевыпуск токена выполняется только по явному запросу с предупреждением о необходимости обновить подключения существующих клиентов.
Работа со структурой MODX
Одно из основных отличий MODX3MCP от обычного доступа к серверу — понимание структуры MODX.
Для агента ресурс остаётся ресурсом, шаблон — шаблоном, чанк — чанком, TV — TV-полем.
Это позволяет не просто изменять данные, а предварительно исследовать проект: искать связанные элементы, определять места использования и оценивать возможные последствия изменения.
В состав компонента входит граф зависимостей, который показывает связи между элементами MODX и помогает обнаруживать:
- использование чанков и сниппетов;
- связи шаблонов и TV-полей;
- вызовы одних элементов из других;
- отсутствующие зависимости;
- потенциально неиспользуемые элементы;
- участки проекта, которые могут быть затронуты изменением.
Интерфейс графа зависимостей адаптирован для работы непосредственно в менеджере MODX. Предусмотрены фильтры, масштабирование и прокрутка рабочей области, что упрощает исследование структуры крупных проектов.
Контроль изменений
MODX3MCP рассчитан не только на чтение данных, но и на работу с реальными проектами, поэтому значительная часть функциональности связана с контролем изменяющих операций.
Начиная с версии 1.2.0 компонент поддерживает защиту от записи по устаревшему состоянию сайта. Агент может получить текущую ревизию проекта через
get_site_stateЕсли при выполнении защищённой операции обнаруживается, что данные уже изменены другим агентом или процессом, операция отклоняется с ошибкой
STALE_STATEВ текущей версии усилена защита изменений TV-полей. Механизм CAS v2 позволяет проверять ревизию сайта и исходные значения изменяемых TV под общей блокировкой, а несколько значений сохранять в одной транзакции. Проверка исходного состояния также предусмотрена при изменении отдельных свойств элементов.
Важно: защита от конкурентных изменений действует при использовании соответствующих предварительных условий. Прямые обращения к API без этих условий не гарантируют защиту от перезаписи данных, изменённых другим агентом.
В компоненте предусмотрены:
- разделение операций чтения и изменения;
- предварительная проверка ряда действий;
- предварительный просмотр для некоторых изменяющих и массовых операций;
- ограничения для потенциально опасных операций;
- возможность отключения отдельных групп команд;
- сохранение настроек и API-токена при обновлении компонента.
При использовании штатного MCP-клиента дополнительно доступны защитные резервные копии перед рядом изменяющих операций, блокировка параллельных записей в рамках одного проекта и передача сведений о выполненных изменениях во внешнюю систему аудита.
При этом MODX3MCP не гарантирует правильность решений самого ИИ-агента. Агент может неправильно понять поставленную задачу или выбрать неподходящий способ её выполнения.
Действующий API-токен предоставляет широкие полномочия для работы с MODX. Отключение отдельных групп инструментов не является полноценным разграничением прав между внешними пользователями.
Поэтому права и возможности агента должны соответствовать конкретному проекту и задачам, которые ему разрешено выполнять.
Совместимость
Эта версия компонента предназначена для MODX Revolution 3.x.
Что потребуется дополнительно
Установка MODX3MCP — это только установка MODX-части системы.
После установки необходимо настроить API, обеспечить безопасное хранение токена и подключить внешний MCP-клиент. При новой установке API компонента по умолчанию выключен и требует явного включения администратором.
Для получения полноценного рабочего агента необходимо отдельно организовать внешний контур: подключить ИИ-агента, настроить его взаимодействие с MODX3MCP и определить правила его работы.
При необходимости можно дополнительно использовать Telegram-бота как общий интерфейс постановки задач. Это удобно, например, когда над одним проектом работают несколько человек.
Конкретная конфигурация зависит от того, какой ИИ, какой интерфейс и какой уровень автоматизации необходим пользователю.
Настройка внешнего контура обычно требует участия специалиста: подключение ИИ-агента, настройка взаимодействия с MODX3MCP, прав доступа и правил работы выполняются с учётом особенностей конкретного проекта.
Лицензия и исходный код
MODX3MCP распространяется бесплатно по лицензии MIT.
Исходный код проекта и готовые релизы находятся в открытом репозитории GitHub:
https://github.com/rumata-estor/modx3-mcp
Языки интерфейса и документация
Начиная с версии 1.2.4, административная панель MODX MCP и граф зависимостей переведены на 9 языков: русский (ru), английский (en), испанский (es), немецкий (de), французский (fr), украинский (uk), казахский на кириллице (kk), нидерландский (nl) и польский (pl).
Инструкции по установке, безопасности, настройкам и описания всех 192 MCP-инструментов доступны на этих языках. Названия API-команд, параметры и примеры кода остаются неизменными. Подробные технические схемы API и CHANGELOG ведутся на русском и английском.
Версия 1.2.4
- Полностью локализованы административная панель и граф зависимостей на 9 языков: русский (ru), английский (en), испанский (es), немецкий (de), французский (fr), украинский (uk), казахский (кириллица, kk), нидерландский (nl), польский (pl).
- Для каждого языка переведены 166 строк интерфейса, включая управление API-токеном, настройками, группами возможностей и диагностикой графа.
- Обновлена многоязычная документация на GitHub: установка, безопасность, 16 системных настроек, описания всех 192 инструментов.
- Контракт MCP не изменён: 193 серверных действия и 192 публичных инструмента.
- При штатном обновлении сохраняются существующие настройки и API-токен.
- Проверена совместимость с MODX Revolution 3.2.4-pl.
Документация: https://github.com/rumata-estor/modx3-mcp/blob/main/docs/LANGUAGES.md Релиз: https://github.com/rumata-estor/modx3-mcp/releases/tag/v1.2.4
Версия 1.2.3
- Исправлены ссылки на документацию в окне установки транспортных пакетов MODX 2 и MODX 3
- Ссылки на README, CHANGELOG и изображения теперь ведут непосредственно на GitHub
- Исходные файлы документации при сборке транспортного пакета остаются без изменений
- Добавлены автоматические проверки ссылок, административной панели и графа зависимостей
- Сохранён публичный контракт из 192 инструментов MCP и 193 серверных действий
- При обновлении сохраняются существующие системные настройки и API-токен
- Проверена работа на MODX Revolution 3.2.4-pl
Версия 1.2.1
- Исправлены уязвимости при работе с системными настройками MCP и статическими файлами.
- Добавлена защита от выхода за пределы разрешённых каталогов, включая символические ссылки.
- Усилена защита API-токена и HTTPS-соединений.
- Исправлена возможность неограниченной выборки записей при limit=0.
- При новой установке компонент по умолчанию выключен.
- При обновлении сохраняются существующие настройки и API-токен.
- Проверена работа на MODX Revolution 3.2.4-pl.
Версия 1.2.0
- Публичный контракт расширен со 182 до 192 действий: 81 операция чтения и 111 изменяющих операций.
- Добавлен механизм optimistic locking / CAS для защиты от записи по устаревшему состоянию при параллельной работе агентов.
- Добавлены get_site_state, site revision и проверка preconditions перед изменениями. Устаревшие операции отклоняются с STALE_STATE.
- Добавлены операции чтения и изменения настроек ClientConfig.
- Добавлены операции чтения для Access Policies, шаблонов политик, групп ресурсов и состава групп.
- Расширены безопасные модульные операции изменения, включая работу с Lexicon.
- В чтение ресурсов добавлено состояние удаления для сценариев recycle/undelete.
- Исправлена сортировка настроек ClientConfig.
- Улучшены проверки совместимости MODX 2 и MODX 3, release-smoke и тесты конкурентной записи.
- Проверена работа на MODX Revolution 2.8.9-pl и MODX Revolution 3.2.4-pl.
Версия 1.2.1
- Исправлены уязвимости при работе с системными настройками MCP и статическими файлами.
- Добавлена защита от выхода за пределы разрешённых каталогов, включая символические ссылки.
- Усилена защита API-токена и HTTPS-соединений.
- Исправлена возможность неограниченной выборки записей при limit=0.
- При новой установке компонент по умолчанию выключен.
- При обновлении сохраняются существующие настройки и API-токен.
- Проверена работа на MODX Revolution 3.2.4-pl.
Версия 1.2.0
- Публичный контракт расширен со 182 до 192 действий: 81 операция чтения и 111 изменяющих операций.
- Добавлен механизм optimistic locking / CAS для защиты от записи по устаревшему состоянию при параллельной работе агентов.
- Добавлены get_site_state, site revision и проверка preconditions перед изменениями. Устаревшие операции отклоняются с STALE_STATE.
- Добавлены операции чтения и изменения настроек ClientConfig.
- Добавлены операции чтения для Access Policies, шаблонов политик, групп ресурсов и состава групп.
- Расширены безопасные модульные операции изменения, включая работу с Lexicon.
- В чтение ресурсов добавлено состояние удаления для сценариев recycle/undelete.
- Исправлена сортировка настроек ClientConfig.
- Улучшены проверки совместимости MODX 2 и MODX 3, release-smoke и тесты конкурентной записи.
- Проверена работа на MODX Revolution 2.8.9-pl и MODX Revolution 3.2.4-pl.
Версия 1.2.0
- Публичный контракт расширен со 182 до 192 действий: 81 операция чтения и 111 изменяющих операций.
- Добавлен механизм optimistic locking / CAS для защиты от записи по устаревшему состоянию при параллельной работе агентов.
- Добавлены get_site_state, site revision и проверка preconditions перед изменениями. Устаревшие операции отклоняются с STALE_STATE.
- Добавлены операции чтения и изменения настроек ClientConfig.
- Добавлены операции чтения для Access Policies, шаблонов политик, групп ресурсов и состава групп.
- Расширены безопасные модульные операции изменения, включая работу с Lexicon.
- В чтение ресурсов добавлено состояние удаления для сценариев recycle/undelete.
- Исправлена сортировка настроек ClientConfig.
- Улучшены проверки совместимости MODX 2 и MODX 3, release-smoke и тесты конкурентной записи.
- Проверена работа на MODX Revolution 2.8.9-pl и MODX Revolution 3.2.4-pl.
Версия 1.1.0
- Переход на общую модульную архитектуру для MODX 2 и MODX 3 с платформенными адаптерами.
- Все 182 доступных на тот момент серверных действия переведены на модульный Runtime.
- Из общей кодовой базы готовятся отдельные транспортные пакеты; расширены тесты совместимости, установки и безопасности.
Полный подробный журнал изменений, включая промежуточные выпуски и исходную историю проекта: https://github.com/rumata-estor/modx3-mcp/blob/main/CHANGELOG.ru.md
Последние обсуждения в сообществе MODX.pro