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.
Badge for your README
Markdown
[](/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
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
- # DLE MCP: MCP-сервер для DataLife Engine
- Однофайловый MCP-сервер, через который AI-клиенты (Claude, Cursor, любой MCP-клиент с транспортом Streamable HTTP) управляют сайтом на DataLife Engine: https://dle-news.ru/ новостями, категориями, статическими страницами, картинками, комментариями, пользователями и кешем.
- Файлов две версии, под разные ветки DLE:
- | Файл | DLE | PHP | Версия сервера |
- |---|---|---|---|
- | `mcp-dle21.php` | 21.x | 8.1+ | `1.1.0` |
- | `mcp-dle15.php` | 15.2 | 7.2+ | `1.0.0-dle15.2` |
- ## Как это работает
- Сервер ничего не пишет в базу сам и не меняет файлы DLE. Для каждой операции записи он заполняет `$_GET`/`$_POST` так же, как их заполнила бы форма админпанели, и подключает штатный обработчик DLE:
- - `engine/inc/addnews.php`, `editnews.php`: новости
- - `engine/inc/categories.php`: категории
- - `engine/inc/static.php`: статические страницы
- - `engine/ajax/upload.php`: загрузка картинок
- - любой другой `engine/inc/<mod>.php` через `admin_action`
- Поэтому работает всё, что DLE делает при сохранении из админки: проверки, генерация `alt_name` и мета-тегов, логи действий, очистка кеша, хуки плагинов (`DLEPlugins::Check`). Ответ обработчика (HTML с сообщением, редирект, JSON загрузчика) сервер разбирает и возвращает клиенту в виде структурированного JSON.
- Чтение (списки, получение записей) идёт напрямую через класс `$db` из DLE.
- ## Установка
- 1. Скопируйте нужный файл в корень сайта (рядом с `index.php`) и переименуйте его, например, в `mcp-dle.php`. Корень DLE сервер ищет сам: от своей папки поднимается вверх до каталога, где лежит `engine/data/config.php`. Поэтому файл можно положить и в подпапку.
- 2. Откройте файл и задайте настройки в начале:
- ```php
- const MCP_KEY = 'длинный-случайный-ключ'; // обязательно смените '1234'
- const MCP_USER = ''; // логин DLE, от имени которого идут действия
- ```
- - `MCP_KEY`: ключ доступа. Пустой ключ запрещает любой доступ.
- - `MCP_USER`: пользователь, от чьего имени работает сервер. Если пусто, берётся первый пользователь из группы 1 (администраторы). У пользователя должен быть доступ в админпанель (`allow_admin`), и он не должен быть забанен.
- 3. Сгенерировать ключ можно так:
- ```bash
- openssl rand -hex 32
- ```
- ## Адрес и авторизация
- ```
- https://ваш-сайт/mcp-dle.php?key=MCP_KEY
- ```
- Ключ принимается двумя способами:
- - в параметре `?key=...`
- - в заголовке `Authorization: Bearer MCP_KEY`
- Если nginx или Apache не передают заголовок `Authorization` в PHP, используйте `?key=` или пробросьте заголовок (на Apache: `RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]`).
- Транспорт: MCP Streamable HTTP, JSON-RPC 2.0 только через `POST`. Сессий и потока от сервера нет: `GET` получает `405`. Пакетные запросы (batch) не поддерживаются, кроме массива из одного запроса.
- Поддерживаемые версии протокола: `2025-11-25`, `2025-06-18`, `2025-03-26`, `2024-11-05`.
- ## Подключение к Claude
- Добавьте кастомный коннектор и укажите URL с ключом:
- ```
- https://ваш-сайт/mcp-dle.php?key=ваш-ключ
- ```
- В клиентах, которые настраиваются через JSON (Claude Code, Cursor и т. п.):
- ```json
- {
- "mcpServers": {
- "dle": {
- "type": "http",
- "url": "https://ваш-сайт/mcp-dle.php",
- "headers": { "Authorization": "Bearer ваш-ключ" }
- }
- }
- }
- ```
- ## Проверка через curl
- ```bash
- # рукопожатие
- curl -s -X POST 'https://ваш-сайт/mcp-dle.php?key=КЛЮЧ' \
- -H 'Content-Type: application/json' \
- -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}'
- # список инструментов
- curl -s -X POST 'https://ваш-сайт/mcp-dle.php?key=КЛЮЧ' \
- -H 'Content-Type: application/json' \
- -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
- # сводка по сайту
- curl -s -X POST 'https://ваш-сайт/mcp-dle.php?key=КЛЮЧ' \
- -H 'Content-Type: application/json' \
- -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"dle_info","arguments":{}}}'
- ```
- ## Инструменты
- Рекомендуемый первый шаг для клиента: `dle_info`, `category_list`, `xfields_list`.
- ### Сайт
- | Инструмент | Что делает |
- |---|---|
- | `dle_info` | Версия DLE, URL, шаблон, язык, часовой пояс, пользователь, от имени которого идут действия, счётчики (новости, на модерации, категории, статика, комментарии, пользователи), группы пользователей. |
- | `cache_clear` | Очистка кеша DLE. `all: true` также чистит системные кеши (шаблоны, плагины, opcache). |
- ### Новости
- | Инструмент | Параметры |
- |---|---|
- | `news_list` | `limit` (по умолчанию 20, максимум 200), `offset`, `category`, `approve`, `search` (подстрока заголовка), `author`, `order` (`date`, `id`, `title`, `comm_num`, `news_read`), `direction` (`desc`/`asc`) |
- | `news_get` | `id`: полная новость с `short_story`, `full_story`, `xfields`, мета-тегами и флагами |
- | `news_add` | обязателен `title`, остальное ниже |
- | `news_edit` | обязателен `id`. Меняются только переданные поля, остальные берутся из базы точно так, как их заполнила бы форма редактирования |
- | `news_delete` | `id`: удаляет новость вместе с комментариями и файлами |
- Поля `news_add` / `news_edit`:
- - `title`, `short_story`, `full_story` (HTML)
- - `category`: массив id категорий
- - `tags`: массив строк
- - `xfields`: объект `имя => значение` (список полей в `xfields_list`)
- - `approve`, `allow_main`, `allow_comments`, `allow_rating`, `fixed`
- - `alt_name`, `date` (`YYYY-MM-DD HH:MM:SS`), `author` (логин)
- - `meta_title`, `meta_description`, `meta_keywords`
- - `disable_index`, `disable_search`
- - `password` (пустая строка снимает пароль)
- - `reason`: причина редактирования (только `news_edit`)
- - `auto_line_breaks`: только DLE 15.2, см. отличия ниже
- - `extra`: любые другие поля формы админки как есть
- По умолчанию `news_add` публикует новость (`approve`), выводит на главную, разрешает комментарии, рейтинг и RSS. Несуществующие категории и доп. поля отклоняются ещё до вызова DLE, с подсказкой, каким инструментом посмотреть допустимые значения.
- ### Категории
- | Инструмент | Параметры |
- |---|---|
- | `category_list` | `full: true` добавляет мета-теги, шаблоны, сортировку |
- | `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` |
- | `category_edit` | обязателен `id`, меняются только переданные поля |
- | `category_delete` | `id`. Если в категории или подкатегориях есть новости, нужен `news_action`: `detach` (убрать категорию у новостей), `move` (перенести в `move_to`), `delete` (удалить новости) |
- ### Статические страницы
- | Инструмент | Параметры |
- |---|---|
- | `static_list` | `limit`, `offset`, `search` (по имени или заголовку) |
- | `static_get` | `id` или `name` |
- | `static_add` | обязательны `name` (латиница, страница откроется как `/name.html`), `description` (заголовок), `template` (содержимое) |
- | `static_edit` | обязателен `id`, меняются только переданные поля |
- | `static_delete` | `id` |
- Дополнительные поля: `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`.
- Страница правил сайта (`dle-rules-page`) через `static_edit` не редактируется. Для неё нужен `admin_action` с `mod=static`, `action=dosaveedit`, `get={"page":"rules"}`.
- ### Картинки
- `image_upload` скачивает картинку по внешней ссылке через штатный загрузчик DLE (`engine/ajax/upload.php`, как поле «загрузить по ссылке»). Применяются все настройки сайта: ресайз, миниатюры, водяной знак, удалённое хранилище.
- | Параметр | Описание |
- |---|---|
- | `url` | http(s)-ссылка на картинку (обязательно) |
- | `news_id` | к какой новости привязать (или id статической страницы при `target: "static"`). Без него картинка привяжется к следующей новости, созданной через `news_add` |
- | `xfield` | имя доп. поля типа `image` или `imagegalery`: картинка обработается с настройками этого поля |
- | `target` | `news` (по умолчанию) или `static` |
- | `thumb`, `watermark` | создать миниатюру / наложить водяной знак (по умолчанию из настроек сайта) |
- | `filename` | только DLE 15.2: имя файла, если ссылка не заканчивается на имя картинки |
- Ответ содержит `url` (локальный адрес), при наличии `thumb_url` и `medium_url`, а также готовый `img_tag` для вставки в текст. Если указан `xfield`, ответ содержит `xfvalue`: его нужно передать в `xfields` при `news_add` / `news_edit` (для галереи несколько значений перечисляются через запятую).
- Защита от SSRF: скачивание разрешено только с публичных адресов. Хосты, которые резолвятся в частные или зарезервированные диапазоны, отклоняются, как и ссылки на сам сайт.
- ### Доп. поля, комментарии, пользователи
- | Инструмент | Что делает |
- |---|---|
- | `xfields_list` | Список доп. полей новостей: имя, описание, тип, обязательность, категории, варианты для `select` |
- | `comments_list` | `limit`, `offset`, `news_id`, `approve` |
- | `comment_delete` | `id`: удаляет комментарий (и ответы на него при древовидных комментариях) через функцию DLE `deletecomments()` и чистит связанный кеш |
- | `users_list` | `limit`, `offset`, `group`, `search` (логин или e-mail) |
- ### Всё остальное: `admin_action`
- Запускает любой модуль админпанели `engine/inc/<mod>.php` с правами администратора, как запрос к `admin.php?mod=<mod>&action=<action>`. Токен `user_hash` подставляется автоматически.
- | Параметр | Описание |
- |---|---|
- | `mod` | имя модуля, например `editusers` (только `[a-z0-9_]`, файл должен существовать) |
- | `action` | действие модуля, например `adduser` |
- | `get` | параметры строки запроса |
- | `post` | поля формы |
- | `max_chars` | максимальная длина текста страницы в ответе (по умолчанию 4000) |
- Подходит для пользователей, групп, настроек, баннеров, ссылок, редиректов и всего, что не покрыто отдельными инструментами. Если модуль вывел сообщение DLE, возвращается оно; если обычную страницу, то её текст без обвязки админки.
- ## Формат ответов
- Каждый вызов инструмента возвращает один текстовый блок с JSON. У операций записи всегда есть поля `ok` и `status` (`success`, `error`, `warning`, `info`, `page`), а также `title` и `message` из сообщения DLE. При ошибке ставится `isError: true`.
- После записи сервер перечитывает запись из базы и добавляет её в ответ (`news`, `category`, `page`), чтобы клиент сразу видел итог: id, `alt_name`, ссылку на сайт. Успех удаления проверяется по факту отсутствия записи в базе, а не только по сообщению DLE.
- Если обработчик DLE завершился через `die()` или упал с фатальной ошибкой, сервер всё равно возвращает корректный JSON-RPC ответ с текстом ошибки (через `register_shutdown_function`).
- ## Отличия версий
- ### `mcp-dle21.php` (DLE 21)
- - Нужен PHP 8.1+ (типизированные статические свойства, `array_is_list`).
- - Доп. поля читаются из `engine/data/xfields.json`.
- - Ссылки на новости строятся через `DLEUrl::BuildUrl()`.
- - Список категорий передаётся в обработчик через поле `category_custom_sort` (с включённым `allow_cat_sort`), потому что `addnews.php` / `editnews.php` читают основной список через `filter_input()`.
- - В `image_upload` дополнительно разрешён формат `heic`.
- ### `mcp-dle15.php` (DLE 15.2)
- - Работает на PHP 7.2+ (полифил `array_is_list`).
- - Доп. поля читаются из `engine/data/xfields.txt` (через `xfieldsload()`).
- - Поля `select` в форме DLE 15.2 отправляются по индексу варианта. Сервер принимает значение или подпись варианта и сам переводит их в индекс; неизвестное значение отклоняется со списком допустимых.
- - Проверка обязательных доп. полей: при `news_add` все обязательные поля (с учётом категорий и групп) должны быть заполнены; при `news_edit` переданное обязательное поле нельзя сделать пустым. Иначе DLE 15.2 молча пропустил бы непереданное поле.
- - Несуществующий `author` отклоняется (DLE молча подставил бы текущего пользователя).
- - Параметр `auto_line_breaks` (поле `allow_br`): тексты как обычный текст с автопереносами. При `news_edit` режим старой новости сохраняется, если не переданы новые тексты.
- - Ссылки на новости и статику строятся по правилам ЧПУ из настроек (`allow_alt_url`, `seo_type`), так же как в `addnews.php`.
- - `image_upload`: загрузчик DLE 15.2 берёт имя файла из последнего сегмента ссылки и требует расширение картинки. Если ссылка его не содержит, передайте `filename` (например, `film-2026.jpg`). Сервер также задаёт `User-Agent` (многие хостинги картинок без него отказывают), проверяет существование новости до загрузки и добавляет лимит размера из настроек в текст ошибки «слишком большой файл». Ссылки, содержащие `.php`, DLE не скачивает, сервер сообщает об этом заранее.
- - `admin_action`: если модуль ничего не вывел, это считается ошибкой («скорее всего, такого действия нет, ничего не изменено»).
- - Текст фатальных ошибок PHP обрезается до первой строки, чтобы в ответ не попал stack trace с аргументами (паролями, SQL).
- ## Безопасность
- - **Ключ даёт полные права администратора.** Через `admin_action` доступна вся админпанель. Используйте длинный случайный ключ и HTTPS.
- - Ключ в `?key=` попадает в логи веб-сервера. Если это критично, передавайте его в заголовке `Authorization: Bearer`.
- - Для отдельного пользователя под MCP создайте учётку в группе с доступом в админку и укажите её в `MCP_USER`: в логах действий DLE будет видно, что изменения сделаны через MCP.
- - Доступ можно дополнительно ограничить на уровне nginx (по IP, через `limit_req`) или переименовать файл в неочевидное имя.
- - Ключ сравнивается через `hash_equals()`, при пустом `MCP_KEY` сервер отказывает во всех запросах.
- - На неактивированной (триальной) копии DLE сервер соблюдает те же лимиты, что и `admin.php` (больше 100 новостей или 200 комментариев блокируют запись, кроме редактирования новостей).
- ## Ограничения
- - Только инструменты: `resources/list` и `prompts/list` возвращают пустые списки.
- - Нет сессий и уведомлений от сервера.
- - Один запрос выполняет один инструмент: batch JSON-RPC не поддерживается.
- - Сервер полагается на разметку сообщений админпанели DLE (`message_box`). Если шаблон админки сильно переделан, статусы могут определяться как `text` / `page`.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.