MCP сервер, ver. 1.0.0

Модуль создан с целью улучшить качество разработки проектов на Битрикс с использованием AI-агентов.

Модуль реализует MCP сервер в виде набора эндпоинтов, которые используются для связи AI-агента среды разработки непосредственно с сайтом и сервером.

Возможности MCP сервера

Ресурсы:
- Добавляет документацию Bitrix Framework в ресурсы MCP сервера, к которым агент может обращаться напрямую

Инструменты:

• Информация об окружении:
  • Информация о системе:
    • Название операционной системы;
      
    • Имя хоста;
      
    • Имя текущего пользователя;
      
    • Объем диска в байтах;
      
    • Объем свободного места на диске в байтах;
      
  • Информация о Битрикс:
    • Редакция;
      
    • Версия главного модуля;
      
    • Установленные модули;
      
  • Информация о PHP:
    • Версия PHP;
      
    • Подключенные расширения;
      
    • Ограничение по объему доступной оперативной памяти;
      
    • Максимальное время исполнения PHP-скриптов;
      
  • Информация о базе данных:
    • Тип базы данных;
      
    • Версия сервера баз данных;
      
    • Хост подключения;
      
    • Имя базы данных;
      
• Live API:
  • Список доступных функций в модуле;
    
  • Список доступных событий в модуле;
    
  • Поиск функций в модулях по проиндексированной базе;
    
  • Код функции модуля с её описанием PHPDoc;
    
  • Поиск функций через механизм Reflection по всему коду;
    
• Исполнение PHP-кода на сервере;
  
• Исполнение Shell-команд на сервере;
  
• Исполнение SQL-запросов на сервере;
  
• Поиск по документации Bitrix Framework (требует дополнительного подключения сервиса генерации embeddings):
  • Нормализует markdown-файлы документации Bitrix Framework перед индексированием;
    
  • Индексирует markdown-файлы документации Bitrix Framework в формате embeddings для поиска по смыслу, а не по вхождению;
    
  • Производит векторный поиск по документации Bitrix Framework по запросу от AI-агента.
    

Доступные события в модуле

Имя события	Когда вызывается	Параметры
OnBeforeExec	Перед исполнением shell-команд	['command' => (string) $command] Команда на исполнение
OnAfterExec	После исполнения shell-команд	['output' => (array) $output] Массив с построчным выводом исполненной команды
OnBeforeEval	Перед исполнением PHP-кода	['code' => (string) $code] Код на исполнение
OnAfterEval	После исполнения PHP-кода	['output' => (string) $output] Экранный вывод исполненного кода
OnBeforeSql	Перед исполнением SQL-кода	['query' => (string) $query] SQL-запрос(ы) на исполнение
OnAfterSql	После исполнения SQL-кода	[    'columns' => (array) $columns,    'rows' => (array) $rows,    'rowCount' => (int) count($rows),    'query' => (string) $query ]; Массив с результатом SQL-запроса
OnBeforeGenerateEmbedding	Перед отправкой данных в сервис генерации эмбеддингов	[    'url' => (string) self::GENERATE_EMBEDDINGS_ENDPOINT,    'data' => Json::encode(['text' => $text]),    'headers' => [        'Content-Type' => 'application/json',    ],    'timeout' => $this->timeout,    'waitResponse' => true ] Массив с данными запроса
OnAfterGenerateEmbedding	После получения данных от сервиса генерации эмбеддингов	['response' => (bool|string) $response] Результат POST-запроса через \Bitrix\Main\Web\HttpClient

Безопасность

Доступ AI-агентов к модулю реализован с помощью JWT-токенов с возможностью указания времени жизни и прав токена на отдельные эндпоинты. Доступно удаление идентификаторов токенов со страницы настроек модуля, чтобы заблокировать доступ по ранее выпущенному токену.

Есть возможность ограничить доступ к настройкам модуля определенным группам пользователей.

Доступно логирование запросов/ответов к внешнему API модуля.

Токены с правами на исполнение PHP/Shell/SQL кода рекомендуется использовать только на тестовых площадках! Помните, что AI-агенты ошибаются и могут удалить или испортить ваши данные.