3. Описание MCP-сервера › 3.5 Репозиторий › repo_read

Читает репозиторий: список тем раздела, историю темы или записи.

Право

«Репозиторий → Чтение данных» (AGENT_REPO_READ). Каждое действие пропускает ещё флаг раздела — «Репозиторий».

Параметры

Параметр	Тип	Что это
`action`	строка	`topic_list`, `store_list` или `store_read`
[`repo`]	число	номер раздела из `repo_list` — для `topic_list`
[`find`]	строка	только темы, у которых это слово есть в `name`, `descr` или `params`, — для `topic_list`
[`offset`]	число	сколько строк пропустить до страницы; по умолчанию 0
[`topic`]	число	номер темы из `topic_list` — для `store_list` и `store_read`
[`topics`]	список чисел	несколько тем сразу — для `store_read`
[`record`]	число	одна запись истории по номеру из `store_list` — для `store_read` вместо тем
[`appendix`]	логический	отдать и `appendix` записей — для `store_read`
[`output`]	строка	папка на этом компьютере — абсолютный путь или путь от папки магазина — для текстов записей, для `store_read`

Страница — до 100 строк; total говорит, сколько их всего, offset пропускает уже прочитанные.

topic_list

Темы раздела, первыми — те, куда писали последними; темы без записей — в конце.

{"repo": 2, "path": "Проба -> Цены",
 "topics": {"columns": ["id", "name", "descr", "params", "records", "last_time", "last_author", "last_user"],
            "rows": [[1, "Телескопы Levenhuk", "Цены конкурентов на телескопы Levenhuk: сводка по магазинам",
                      "levenhuk telescope competitors", 2, "2026-09-28 02:26:40",
                      "Claude Opus 5.5, effort medium, Claude Code", "Администратор"]]},
 "total": 1, "offset": 0}

Колонка	Что это
`id`	номер темы
`name`, `descr`, `params`	имя, описание и слова темы
`records`	сколько в теме записей
`last_time`, `last_author`, `last_user`	когда, кем и чьим ассистентом сделана последняя запись; пусто, если записей нет

Если по find ничего нет, вторым блоком идёт No topic of the section matches ….

store_list

История темы без текстов, первыми — новые записи.

{"topic": 1, "name": "Телескопы Levenhuk",
 "records": {"columns": ["id", "author", "user", "date_time", "comment", "size"],
             "rows": [[2, "Claude Opus 5.5, effort medium, Claude Code", "Администратор",
                       "2026-09-28 02:26:40", "Добавлен Телескоп-Маркет, цена Astroscope поднялась", 158]]},
 "total": 2, "offset": 0}

size — размер body в байтах.

store_read

Текущие записи тем — последняя запись каждой из topic и topics, — или одна запись истории по record.

{"records": [{"id": 2, "topic": 1, "name": "Телескопы Levenhuk",
              "author": "Claude Opus 5.5, effort medium, Claude Code", "user": "Администратор",
              "date_time": "2026-09-28 02:26:40", "comment": "Добавлен Телескоп-Маркет, цена Astroscope поднялась",
              "size": 158, "appendix_size": 130, "body": "# Levenhuk …"}],
 "empty": [2], "missed": [99]}

Поле	Что это
`records`	записи: номер, тема и её имя, автор, человек, время, `comment`, размер и текст `body`; `appendix_size` — размер приложения, само `appendix` — только с `appendix: true`
`empty`	темы, в которых записей ещё нет
`missed`	номера, под которыми тем нет

С output тексты ложатся в указанную папку: body — в <тема>.<запись>.txt, appendix — в <тема>.<запись>.appendix.txt, а в записи вместо них стоят пути file и appendix_file.

Отказы

Ответ	Когда
`action is one of topic_list, store_list, store_read`	нет `action` или оно другое
`repo is the number of a section…`, `topic is the number of a topic…`, `record is the number of a record…`, `topics are the numbers of topics…`	номер не указан или это не целое число больше нуля
`topics is required…`	для `store_read` нет ни `topic`, ни `topics`, ни `record`
`offset is the number of rows to skip, 0 or more`	`offset` — не целое число от нуля
`No section … is open to you - repo_list shows yours`	раздела нет, это папка или у агента в нём нет ни одного флага
`No topic … - topic_list of its section shows them`	темы с таким номером нет
`No record … - store_list shows the history of a topic`	записи с таким номером нет
`ACCESS_DENIED: your rights in section […] do not hold …`	в разделе нет флага, который нужен действию
`Cannot write …`, `Cannot create folder …`	папку `output` не удалось создать или записать в неё

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