Версия 1.1.0-pl
Дата выпуска 04.10.2026
Загрузки 0
Просмотры 5
Внимание, этот компонент требует PHP 8.1 или выше!
Внимание, этот компонент требует MODX 3 или выше.
MODX MCP — компонент для подключения внешних ИИ-агентов к MODX Revolution 3.x через протокол Model Context Protocol.

Важно: MODX MCP не является готовым ИИ-агентом и не добавляет искусственный интеллект в MODX сам по себе.

После установки компонента в панели управления не появится чат, которому можно сразу поручать работу с сайтом. Компонент решает другую задачу: он создаёт специальный интерфейс между MODX и внешней агентной системой.

То есть MODX MCP — это одна из частей более крупного контура:

Пользователь → ИИ-агент → MODX MCP → MODX

Пользовательский интерфейс, сам ИИ-агент и организация его работы находятся за пределами компонента. Например, интерфейсом для постановки задач может быть Telegram-бот, через который с одним проектом одновременно работает несколько участников команды.

Такая архитектура позволяет не встраивать конкретный ИИ-сервис непосредственно в MODX и не привязывать компонент к одной модели, одному чату или одному способу управления.

Что делает MODX MCP


MODX MCP предоставляет внешнему агенту специализированный набор инструментов для работы с MODX.

Вместо произвольного доступа к базе данных или файловой системе агент получает возможность работать непосредственно с сущностями CMS:

  • ресурсами и структурой сайта;
  • шаблонами;
  • чанками;
  • сниппетами;
  • плагинами;
  • TV-полями и их значениями;
  • системными настройками;
  • категориями;
  • контекстами;
  • пользователями и группами;
  • источниками файлов и медиа;
  • пакетами и установленными дополнениями;
  • наборами свойств;
  • MIGX;
  • miniShop2;
  • VersionX;
  • VirtualPage.

В текущей версии реализовано более 180 операций для получения информации, анализа структуры проекта и внесения изменений.

Работа со структурой MODX


Одно из основных отличий MODX MCP от обычного доступа к серверу — понимание структуры MODX.

Для агента ресурс остаётся ресурсом, шаблон — шаблоном, чанк — чанком, TV — TV-полем.

Это позволяет не просто изменять данные, а предварительно исследовать проект: искать связанные элементы, определять места использования и оценивать возможные последствия изменения.

В состав компонента входит граф зависимостей, который показывает связи между элементами MODX и помогает обнаруживать:

  • использование чанков и сниппетов;
  • связи шаблонов и TV-полей;
  • вызовы одних элементов из других;
  • отсутствующие зависимости;
  • потенциально неиспользуемые элементы;
  • участки проекта, которые могут быть затронуты изменением.

Контроль изменений


MODX MCP рассчитан не только на чтение данных, но и на работу с реальными проектами, поэтому значительная часть функциональности связана с контролем изменяющих операций.

В компоненте предусмотрены:

  • разделение операций чтения и изменения;
  • предварительная проверка ряда действий;
  • резервное копирование перед изменениями;
  • ограничения для потенциально опасных операций;
  • возможность отключения отдельных групп команд;
  • блокировка параллельных изменяющих операций;
  • сохранение настроек при обновлении компонента;
  • возможность передавать сведения о выполненных изменениях во внешнюю систему аудита.

При этом MODX MCP не гарантирует правильность решений самого ИИ-агента. Агент может неправильно понять поставленную задачу или выбрать неподходящий способ её выполнения.

Поэтому права и возможности агента должны соответствовать конкретному проекту и задачам, которые ему разрешено выполнять.

Совместимость


Эта версия компонента предназначена для MODX Revolution 3.x.

Для MODX Revolution 2.8.x выпускается отдельная версия компонента.

Что потребуется дополнительно


Установка MODX MCP — это только установка MODX-части системы.

Для получения полноценного рабочего агента необходимо отдельно организовать внешний контур: подключить ИИ-агента, настроить его взаимодействие с MODX MCP и определить правила его работы.

При необходимости можно дополнительно использовать Telegram-бота как общий интерфейс постановки задач. Это удобно, например, когда над одним проектом работают несколько человек.

Конкретная конфигурация зависит от того, какой ИИ, какой интерфейс и какой уровень автоматизации необходим пользователю.

Настройка внешнего контура обычно требует участия специалиста: подключение ИИ-агента, настройка взаимодействия с MODX MCP, прав доступа и правил работы выполняются с учётом особенностей конкретного проекта.

Лицензия и исходный код


MODX MCP распространяется бесплатно по лицензии MIT.

Исходный код проекта и готовые релизы находятся в открытом репозитории GitHub:
https://github.com/rumata-estor/modx3-mcp

Последние обсуждения в сообществе MODX.pro