Skip to content
Back to search

datalife-engine-mcp

Single-file MCP server for DataLife Engine (DLE 15.2 / 21). Lets Claude and other MCP clients manage news, categories, static pages, images, comments and users through the stock DLE admin handlers.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/murkirpus--datalife-engine-mcp/badge.svg)](/listings/murkirpus--datalife-engine-mcp)

HTML

<a href="/listings/murkirpus--datalife-engine-mcp"><img src="/api/listings/murkirpus--datalife-engine-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Скопируйте нужный файл в корень сайта (рядом с `index.php`) и переименуйте его, например, в `mcp-dle.php`. Корень DLE сервер ищет сам: от своей папки поднимается вверх до каталога, где лежит `engine/data/config.php`. Поэтому файл можно положить и в подпапку. 2. Откройте файл и задайте настройки в начале:

   const MCP_KEY  = 'длинный-случайный-ключ';  // обязательно смените '1234'
   const MCP_USER = '';                         // логин DLE, от имени которого идут действия

- `MCP_KEY`: ключ доступа. Пустой ключ запрещает любой доступ. - `MCP_USER`: пользователь, от чьего имени работает сервер. Если пусто, берётся первый пользователь из группы 1 (администраторы). У пользователя должен быть доступ в админпанель (`allow_admin`), и он не должен быть забанен.

3. Сгенерировать ключ можно так:

   openssl rand -hex 32

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 249 lines
  1. # DLE MCP: MCP-сервер для DataLife Engine
  2. Однофайловый MCP-сервер, через который AI-клиенты (Claude, Cursor, любой MCP-клиент с транспортом Streamable HTTP) управляют сайтом на DataLife Engine: https://dle-news.ru/ новостями, категориями, статическими страницами, картинками, комментариями, пользователями и кешем.
  3. Файлов две версии, под разные ветки DLE:
  4. | Файл | DLE | PHP | Версия сервера |
  5. |---|---|---|---|
  6. | `mcp-dle21.php` | 21.x | 8.1+ | `1.1.0` |
  7. | `mcp-dle15.php` | 15.2 | 7.2+ | `1.0.0-dle15.2` |
  8. ## Как это работает
  9. Сервер ничего не пишет в базу сам и не меняет файлы DLE. Для каждой операции записи он заполняет `$_GET`/`$_POST` так же, как их заполнила бы форма админпанели, и подключает штатный обработчик DLE:
  10. - `engine/inc/addnews.php`, `editnews.php`: новости
  11. - `engine/inc/categories.php`: категории
  12. - `engine/inc/static.php`: статические страницы
  13. - `engine/ajax/upload.php`: загрузка картинок
  14. - любой другой `engine/inc/<mod>.php` через `admin_action`
  15. Поэтому работает всё, что DLE делает при сохранении из админки: проверки, генерация `alt_name` и мета-тегов, логи действий, очистка кеша, хуки плагинов (`DLEPlugins::Check`). Ответ обработчика (HTML с сообщением, редирект, JSON загрузчика) сервер разбирает и возвращает клиенту в виде структурированного JSON.
  16. Чтение (списки, получение записей) идёт напрямую через класс `$db` из DLE.
  17. ## Установка
  18. 1. Скопируйте нужный файл в корень сайта (рядом с `index.php`) и переименуйте его, например, в `mcp-dle.php`. Корень DLE сервер ищет сам: от своей папки поднимается вверх до каталога, где лежит `engine/data/config.php`. Поэтому файл можно положить и в подпапку.
  19. 2. Откройте файл и задайте настройки в начале:
  20. ```php
  21. const MCP_KEY = 'длинный-случайный-ключ'; // обязательно смените '1234'
  22. const MCP_USER = ''; // логин DLE, от имени которого идут действия
  23. ```
  24. - `MCP_KEY`: ключ доступа. Пустой ключ запрещает любой доступ.
  25. - `MCP_USER`: пользователь, от чьего имени работает сервер. Если пусто, берётся первый пользователь из группы 1 (администраторы). У пользователя должен быть доступ в админпанель (`allow_admin`), и он не должен быть забанен.
  26. 3. Сгенерировать ключ можно так:
  27. ```bash
  28. openssl rand -hex 32
  29. ```
  30. ## Адрес и авторизация
  31. ```
  32. https://ваш-сайт/mcp-dle.php?key=MCP_KEY
  33. ```
  34. Ключ принимается двумя способами:
  35. - в параметре `?key=...`
  36. - в заголовке `Authorization: Bearer MCP_KEY`
  37. Если nginx или Apache не передают заголовок `Authorization` в PHP, используйте `?key=` или пробросьте заголовок (на Apache: `RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]`).
  38. Транспорт: MCP Streamable HTTP, JSON-RPC 2.0 только через `POST`. Сессий и потока от сервера нет: `GET` получает `405`. Пакетные запросы (batch) не поддерживаются, кроме массива из одного запроса.
  39. Поддерживаемые версии протокола: `2025-11-25`, `2025-06-18`, `2025-03-26`, `2024-11-05`.
  40. ## Подключение к Claude
  41. Добавьте кастомный коннектор и укажите URL с ключом:
  42. ```
  43. https://ваш-сайт/mcp-dle.php?key=ваш-ключ
  44. ```
  45. В клиентах, которые настраиваются через JSON (Claude Code, Cursor и т. п.):
  46. ```json
  47. {
  48. "mcpServers": {
  49. "dle": {
  50. "type": "http",
  51. "url": "https://ваш-сайт/mcp-dle.php",
  52. "headers": { "Authorization": "Bearer ваш-ключ" }
  53. }
  54. }
  55. }
  56. ```
  57. ## Проверка через curl
  58. ```bash
  59. # рукопожатие
  60. curl -s -X POST 'https://ваш-сайт/mcp-dle.php?key=КЛЮЧ' \
  61. -H 'Content-Type: application/json' \
  62. -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}'
  63. # список инструментов
  64. curl -s -X POST 'https://ваш-сайт/mcp-dle.php?key=КЛЮЧ' \
  65. -H 'Content-Type: application/json' \
  66. -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
  67. # сводка по сайту
  68. curl -s -X POST 'https://ваш-сайт/mcp-dle.php?key=КЛЮЧ' \
  69. -H 'Content-Type: application/json' \
  70. -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"dle_info","arguments":{}}}'
  71. ```
  72. ## Инструменты
  73. Рекомендуемый первый шаг для клиента: `dle_info`, `category_list`, `xfields_list`.
  74. ### Сайт
  75. | Инструмент | Что делает |
  76. |---|---|
  77. | `dle_info` | Версия DLE, URL, шаблон, язык, часовой пояс, пользователь, от имени которого идут действия, счётчики (новости, на модерации, категории, статика, комментарии, пользователи), группы пользователей. |
  78. | `cache_clear` | Очистка кеша DLE. `all: true` также чистит системные кеши (шаблоны, плагины, opcache). |
  79. ### Новости
  80. | Инструмент | Параметры |
  81. |---|---|
  82. | `news_list` | `limit` (по умолчанию 20, максимум 200), `offset`, `category`, `approve`, `search` (подстрока заголовка), `author`, `order` (`date`, `id`, `title`, `comm_num`, `news_read`), `direction` (`desc`/`asc`) |
  83. | `news_get` | `id`: полная новость с `short_story`, `full_story`, `xfields`, мета-тегами и флагами |
  84. | `news_add` | обязателен `title`, остальное ниже |
  85. | `news_edit` | обязателен `id`. Меняются только переданные поля, остальные берутся из базы точно так, как их заполнила бы форма редактирования |
  86. | `news_delete` | `id`: удаляет новость вместе с комментариями и файлами |
  87. Поля `news_add` / `news_edit`:
  88. - `title`, `short_story`, `full_story` (HTML)
  89. - `category`: массив id категорий
  90. - `tags`: массив строк
  91. - `xfields`: объект `имя => значение` (список полей в `xfields_list`)
  92. - `approve`, `allow_main`, `allow_comments`, `allow_rating`, `fixed`
  93. - `alt_name`, `date` (`YYYY-MM-DD HH:MM:SS`), `author` (логин)
  94. - `meta_title`, `meta_description`, `meta_keywords`
  95. - `disable_index`, `disable_search`
  96. - `password` (пустая строка снимает пароль)
  97. - `reason`: причина редактирования (только `news_edit`)
  98. - `auto_line_breaks`: только DLE 15.2, см. отличия ниже
  99. - `extra`: любые другие поля формы админки как есть
  100. По умолчанию `news_add` публикует новость (`approve`), выводит на главную, разрешает комментарии, рейтинг и RSS. Несуществующие категории и доп. поля отклоняются ещё до вызова DLE, с подсказкой, каким инструментом посмотреть допустимые значения.
  101. ### Категории
  102. | Инструмент | Параметры |
  103. |---|---|
  104. | `category_list` | `full: true` добавляет мета-теги, шаблоны, сортировку |
  105. | `category_add` | обязателен `name`. Также `alt_name`, `parent_id`, `description`, `keywords`, `meta_title`, `full_description`, `icon`, `news_sort`, `news_msort`, `news_number`, `short_tpl`, `full_tpl`, `skin`, `extra` |
  106. | `category_edit` | обязателен `id`, меняются только переданные поля |
  107. | `category_delete` | `id`. Если в категории или подкатегориях есть новости, нужен `news_action`: `detach` (убрать категорию у новостей), `move` (перенести в `move_to`), `delete` (удалить новости) |
  108. ### Статические страницы
  109. | Инструмент | Параметры |
  110. |---|---|
  111. | `static_list` | `limit`, `offset`, `search` (по имени или заголовку) |
  112. | `static_get` | `id` или `name` |
  113. | `static_add` | обязательны `name` (латиница, страница откроется как `/name.html`), `description` (заголовок), `template` (содержимое) |
  114. | `static_edit` | обязателен `id`, меняются только переданные поля |
  115. | `static_delete` | `id` |
  116. Дополнительные поля: `format` (`html` = HTML через фильтр DLE, `text` = текст с автопереносами, `raw` = HTML без фильтра), `meta_title`, `meta_description`, `meta_keywords`, `date`, `groups` (массив id групп или `["all"]`), `use_site_template`, `tpl`, `skin`, `sitemap`, `count_views`, `disable_index`, `disable_search`, `password`, `extra`.
  117. Страница правил сайта (`dle-rules-page`) через `static_edit` не редактируется. Для неё нужен `admin_action` с `mod=static`, `action=dosaveedit`, `get={"page":"rules"}`.
  118. ### Картинки
  119. `image_upload` скачивает картинку по внешней ссылке через штатный загрузчик DLE (`engine/ajax/upload.php`, как поле «загрузить по ссылке»). Применяются все настройки сайта: ресайз, миниатюры, водяной знак, удалённое хранилище.
  120. | Параметр | Описание |
  121. |---|---|
  122. | `url` | http(s)-ссылка на картинку (обязательно) |
  123. | `news_id` | к какой новости привязать (или id статической страницы при `target: "static"`). Без него картинка привяжется к следующей новости, созданной через `news_add` |
  124. | `xfield` | имя доп. поля типа `image` или `imagegalery`: картинка обработается с настройками этого поля |
  125. | `target` | `news` (по умолчанию) или `static` |
  126. | `thumb`, `watermark` | создать миниатюру / наложить водяной знак (по умолчанию из настроек сайта) |
  127. | `filename` | только DLE 15.2: имя файла, если ссылка не заканчивается на имя картинки |
  128. Ответ содержит `url` (локальный адрес), при наличии `thumb_url` и `medium_url`, а также готовый `img_tag` для вставки в текст. Если указан `xfield`, ответ содержит `xfvalue`: его нужно передать в `xfields` при `news_add` / `news_edit` (для галереи несколько значений перечисляются через запятую).
  129. Защита от SSRF: скачивание разрешено только с публичных адресов. Хосты, которые резолвятся в частные или зарезервированные диапазоны, отклоняются, как и ссылки на сам сайт.
  130. ### Доп. поля, комментарии, пользователи
  131. | Инструмент | Что делает |
  132. |---|---|
  133. | `xfields_list` | Список доп. полей новостей: имя, описание, тип, обязательность, категории, варианты для `select` |
  134. | `comments_list` | `limit`, `offset`, `news_id`, `approve` |
  135. | `comment_delete` | `id`: удаляет комментарий (и ответы на него при древовидных комментариях) через функцию DLE `deletecomments()` и чистит связанный кеш |
  136. | `users_list` | `limit`, `offset`, `group`, `search` (логин или e-mail) |
  137. ### Всё остальное: `admin_action`
  138. Запускает любой модуль админпанели `engine/inc/<mod>.php` с правами администратора, как запрос к `admin.php?mod=<mod>&action=<action>`. Токен `user_hash` подставляется автоматически.
  139. | Параметр | Описание |
  140. |---|---|
  141. | `mod` | имя модуля, например `editusers` (только `[a-z0-9_]`, файл должен существовать) |
  142. | `action` | действие модуля, например `adduser` |
  143. | `get` | параметры строки запроса |
  144. | `post` | поля формы |
  145. | `max_chars` | максимальная длина текста страницы в ответе (по умолчанию 4000) |
  146. Подходит для пользователей, групп, настроек, баннеров, ссылок, редиректов и всего, что не покрыто отдельными инструментами. Если модуль вывел сообщение DLE, возвращается оно; если обычную страницу, то её текст без обвязки админки.
  147. ## Формат ответов
  148. Каждый вызов инструмента возвращает один текстовый блок с JSON. У операций записи всегда есть поля `ok` и `status` (`success`, `error`, `warning`, `info`, `page`), а также `title` и `message` из сообщения DLE. При ошибке ставится `isError: true`.
  149. После записи сервер перечитывает запись из базы и добавляет её в ответ (`news`, `category`, `page`), чтобы клиент сразу видел итог: id, `alt_name`, ссылку на сайт. Успех удаления проверяется по факту отсутствия записи в базе, а не только по сообщению DLE.
  150. Если обработчик DLE завершился через `die()` или упал с фатальной ошибкой, сервер всё равно возвращает корректный JSON-RPC ответ с текстом ошибки (через `register_shutdown_function`).
  151. ## Отличия версий
  152. ### `mcp-dle21.php` (DLE 21)
  153. - Нужен PHP 8.1+ (типизированные статические свойства, `array_is_list`).
  154. - Доп. поля читаются из `engine/data/xfields.json`.
  155. - Ссылки на новости строятся через `DLEUrl::BuildUrl()`.
  156. - Список категорий передаётся в обработчик через поле `category_custom_sort` (с включённым `allow_cat_sort`), потому что `addnews.php` / `editnews.php` читают основной список через `filter_input()`.
  157. - В `image_upload` дополнительно разрешён формат `heic`.
  158. ### `mcp-dle15.php` (DLE 15.2)
  159. - Работает на PHP 7.2+ (полифил `array_is_list`).
  160. - Доп. поля читаются из `engine/data/xfields.txt` (через `xfieldsload()`).
  161. - Поля `select` в форме DLE 15.2 отправляются по индексу варианта. Сервер принимает значение или подпись варианта и сам переводит их в индекс; неизвестное значение отклоняется со списком допустимых.
  162. - Проверка обязательных доп. полей: при `news_add` все обязательные поля (с учётом категорий и групп) должны быть заполнены; при `news_edit` переданное обязательное поле нельзя сделать пустым. Иначе DLE 15.2 молча пропустил бы непереданное поле.
  163. - Несуществующий `author` отклоняется (DLE молча подставил бы текущего пользователя).
  164. - Параметр `auto_line_breaks` (поле `allow_br`): тексты как обычный текст с автопереносами. При `news_edit` режим старой новости сохраняется, если не переданы новые тексты.
  165. - Ссылки на новости и статику строятся по правилам ЧПУ из настроек (`allow_alt_url`, `seo_type`), так же как в `addnews.php`.
  166. - `image_upload`: загрузчик DLE 15.2 берёт имя файла из последнего сегмента ссылки и требует расширение картинки. Если ссылка его не содержит, передайте `filename` (например, `film-2026.jpg`). Сервер также задаёт `User-Agent` (многие хостинги картинок без него отказывают), проверяет существование новости до загрузки и добавляет лимит размера из настроек в текст ошибки «слишком большой файл». Ссылки, содержащие `.php`, DLE не скачивает, сервер сообщает об этом заранее.
  167. - `admin_action`: если модуль ничего не вывел, это считается ошибкой («скорее всего, такого действия нет, ничего не изменено»).
  168. - Текст фатальных ошибок PHP обрезается до первой строки, чтобы в ответ не попал stack trace с аргументами (паролями, SQL).
  169. ## Безопасность
  170. - **Ключ даёт полные права администратора.** Через `admin_action` доступна вся админпанель. Используйте длинный случайный ключ и HTTPS.
  171. - Ключ в `?key=` попадает в логи веб-сервера. Если это критично, передавайте его в заголовке `Authorization: Bearer`.
  172. - Для отдельного пользователя под MCP создайте учётку в группе с доступом в админку и укажите её в `MCP_USER`: в логах действий DLE будет видно, что изменения сделаны через MCP.
  173. - Доступ можно дополнительно ограничить на уровне nginx (по IP, через `limit_req`) или переименовать файл в неочевидное имя.
  174. - Ключ сравнивается через `hash_equals()`, при пустом `MCP_KEY` сервер отказывает во всех запросах.
  175. - На неактивированной (триальной) копии DLE сервер соблюдает те же лимиты, что и `admin.php` (больше 100 новостей или 200 комментариев блокируют запись, кроме редактирования новостей).
  176. ## Ограничения
  177. - Только инструменты: `resources/list` и `prompts/list` возвращают пустые списки.
  178. - Нет сессий и уведомлений от сервера.
  179. - Один запрос выполняет один инструмент: batch JSON-RPC не поддерживается.
  180. - Сервер полагается на разметку сообщений админпанели DLE (`message_box`). Если шаблон админки сильно переделан, статусы могут определяться как `text` / `page`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.