3. Описание MCP-сервера › 3.3 Движок › Карта › engine_map_tree

Всё, из чего состоит магазин: модули, папки, файлы и журналы сервера — одним ответом, четырьмя таблицами, или файлом на этом компьютере. С него начинают знакомство с незнакомым магазином.

Право

«Прямой доступ → Разработка → Чтение данных» (AGENT_ENGINE_DEV_READ).

Параметры

Параметр	Тип	Что это
[`path`]	строка	оставить только записи, путь которых содержит эту строку, например `templates/default/images`
[`output`]	строка	путь на этом компьютере — абсолютный или от папки магазина: строки карты пишутся туда, а не в ответ
[`reload`]	да/нет	прочитать дерево из магазина заново

Ответ

{
  "units": {"columns": ["path", "library", "cache", "entry", "lazy", "tables", "includes", "size"],
            "rows": [["./../units/melbis_cataloge.php", false, 1, 0, 0, "store=1|topic=1", "", 1142]]},
  "dirs":  {"columns": ["path", "branch"],
            "rows": [["./../templates/default/statics/base", "static"]]},
  "files": {"columns": ["path", "branch", "type", "size"],
            "rows": [["./../templates/default/statics/base/app.css", "static", "css", 5120]]},
  "logs":  {"columns": ["path", "time", "size"],
            "rows": [["./../core/log/melbis/back.log", "2026-09-15 00:42:15", 27090]]}
}

units — модули

Колонка	Что это
`path`	файл модуля
`library`	модуль-библиотека: его подключают другие модули, своих шаблонов у него нет. Библиотекой движок считает модуль, у которого второе слово имени `inc` или `include` или в имени нет подчёркивания
`cache`	включён ли базовый кеш модуля: `1` или `0`
`entry`	модуль — точка входа: его можно запустить напрямую из корневого скрипта
`lazy`	отложенная загрузка
`tables`	таблицы, от которых зависит кеш модуля: `store=1\\|log=0`
`includes`	подключённые библиотеки: `melbis_inc_auth.php=1`
`size`	размер файла модуля в байтах

dirs и files — папки и файлы

Колонка	Что это
`path`	путь папки или файла
`branch`	часть магазина — см. «Движок»
`type`	только у файлов: расширение в нижнем регистре — `css`, `htm`, `woff2`, у `.htaccess` — `htaccess`; пусто, если расширения нет
`size`	только у файлов: размер в байтах

logs — журналы сервера

Колонка	Что это
`path`	файл журнала в `core/log/`
`time`	время последней записи
`size`	размер в байтах

Что попадает в дерево

модули и библиотеки units/*.php, а среди папок — группы обычных модулей, собранные по началу имени (units/<вендор>_<группа>). На диске таких папок нет, units/ хранит плоский список файлов;
файлы корня сайта, кроме config.json и favicon.ico;
статика, картинки и шаблоны каждой группы вместе с папками. Папка модуля templates/<группа>/units/<модуль> перечисляется для каждого обычного модуля в каждой группе, даже если на диске её нет;
журналы core/log/, кроме сжатых архивов .gz.

С `output`

Строки карты пишутся в файл, по одной на строку: объект с колонками своей таблицы и её именем в table. path сужает и файл. В ответе — путь файла и число строк каждой таблицы:

{"file": "D:\\Melbis\\shop.example.com\\mcp\\claude-code\\map.jsonl",
 "rows": {"units": 57, "dirs": 61, "files": 108, "logs": 3}}

Строка файла:

{"table":"units","path":"./../units/agent_claude_sample.php","library":false,"cache":0,"entry":1,"lazy":0,"tables":"","includes":"","size":982}

Файл перезаписывается при каждом вызове с тем же output.

Текст

Приходит, только если таблицы пусты: либо ни одна запись не подошла под path, либо дерево магазина пусто — такого быть не должно, и это повод обратиться к владельцу.

Отказы

Ответ	Когда
`Cannot write <файл>: …`, `Cannot create folder …`	файл из `output` не удалось записать

Общие отказы — «Ответы и отказы».