Skip to content

MCP: как агент дочитывает длинный список — потолок 500 без продолжения (находка живого прогона) #502

Closed

Description

@bim-ba

О чём решение

Первый живой прогон «три поверхности» (E5, #501) сравнил 56 операций через CLI, MCP и SDK. Данные совпали везде, кроме одного места — и это не ошибка сравнения, а дыра:

Поверхность tracker issues search, один и тот же запрос
CLI с --all 752 задачи
SDK 752
MCP 500, и всё

У инструментов MCP есть потолок на число элементов (500), а способа дочитать остальное у агента нет: ни --all, ни «следующей страницы». Он даже не узнаёт, что получил не всё (это принятая идея 16: сказать об обрыве). Потолок есть у 49 инструментов.

Вы назвали принцип: CLI и MCP — зеркало. Здесь зеркало разбито; вопрос, как его чинить.

Варианты

А. Зеркалить буквально: all=true у инструмента.

tracker_issues_search(query="Queue: DE", all=true)   → 752 задачи одним ответом

Б. Страницы: инструмент отдаёт порцию и говорит, как взять следующую.

tracker_issues_search(query="Queue: DE", limit=100)
→ 100 задач + «показано 100 из 752; дальше: offset=100»
tracker_issues_search(query="Queue: DE", limit=100, offset=100)

Зеркально у CLI появляется --offset (сейчас есть только --limit и --all).

В. Оставить потолок, только сказать об обрыве (идея 16) и посоветовать сузить запрос.

Сравнение

А. all=true Б. Страницы В. Только сообщение
Агент может получить всё да да нет
Ответ помещается в контекст модели нет: 752 задачи — сотни тысяч знаков, клиент обрежет сам и молча да да
CLI и MCP — зеркало да да, если --offset добавить в CLI нет
Работает у сервисов без номера страницы (курсоры, прокрутка) да нужен общий «токен продолжения» вместо offset —
Работа S M: одно место в ядре (обход страниц уже там) S

Рекомендация: Б, с одной поправкой к примеру: не offset, а непрозрачный токен продолжения (next="…"), потому что у сервисов страницы устроены по-разному (номер страницы, курсор, прокрутка в Трекере), а агенту это знать незачем. Ядро уже умеет все три способа; токен — это «с какого места продолжить», выданный ядром.

→ 100 задач + next="eyJwYWdlIjoyfQ"
tracker_issues_search(query="Queue: DE", next="eyJwYWdlIjoyfQ")

То же в CLI (--next) и в SDK (.next у результата рядом с .truncated из идеи 36) — одна вещь на трёх поверхностях.

Заодно: ещё две находки того же прогона

  • 14 операций без инструмента MCP — все про файлы: скачать и загрузить вложение, выгрузить ответы формы. Через MCP файл не передать «как есть»; это идея 25 («ссылкой на ресурс»), вы сказали «потом да». Оставляю как есть, но в таблице покрытия у них появится честная пометка «только CLI и SDK: файл».
  • У 8 операций метод SDK принимает больше аргументов, чем инструмент (expand, fields, page и подобные). Это просто дефекты зеркала; E5 чинит их и проверку ARCH-1, которая их пропустила. Решения не требуется.

Что нужно от вас

«А», «Б» (с токеном) или «В».

Activity

  1. bim-ba commented on Oct 7, 2026

    @bim-ba
    OwnerAuthor

    корнер-кейсы:

    1. я правильно понял что в CLI сейчас доступно либо прочитать 1 страницу либо прочитать все сразу, но пагинация не доступна?
    2. в SDK доступно все, можно и все прочитать и пагинироваться по ресурсу?
    3. в MCP отдается просто первая страница и все, нету ни пагинации ни отдать все сразу?

    ну ты же понимаешь что это странно и не зеркально работает? почему так? мне кажется нам нужно сделать везде зеркальный функционал, разве нет? как делают другие проекты?

  2. bim-ba commented on Oct 7, 2026

    @bim-ba
    OwnerAuthor

    Сначала поправка к моему же описанию выше: я написала, что у MCP «500, и дочитать нечем». Это неточно — проверила по коду (settings.py, HTTPConfig.cap): заданный limit побеждает потолок, то есть агент может попросить limit=1000 и получить все 752. Чего у MCP нет — это «отдай всё» и «продолжи с места, где остановился». Ниже точная картина.

    Как сейчас (проверено по коду и справке команд)

    Ни одна поверхность не отдаёт «одну страницу»: все три сами ходят по страницам сервиса, пока не наберут нужное число.

    Первые N Всё Продолжить с места остановки Если ничего не сказать
    CLI --limit N --all нет 500
    SDK limit=N limit=None нет у методов клиента (лениво перебирать умеет только сессия ядра) всё
    MCP limit=N, любое N нет нет 500

    Ответы на ваши три вопроса:

    1. CLI: не «одна страница или всё», а «первые N (по умолчанию 500) или всё». Взять следующую порцию после первых N — нельзя.
    2. SDK: можно всё и можно первые N; продолжить с N-го — тоже нельзя, только начать заново с большим limit.
    3. MCP: первые N, по умолчанию 500; N можно поднять, но слова «всё» нет, продолжения нет, и о том, что список оборван, агент не узнаёт.

    Да, это не зеркально, причём в трёх местах сразу: разное умолчание (SDK — всё, остальные — 500), «всё» есть не везде, «продолжить» нет нигде. Почему так вышло: каждая поверхность получила своё решение в своё время, а общее знание («где остановились») из ядра наружу не выходит.

    Как у других

    Проект Первые N Всё Продолжить Зеркально между CLI и SDK
    AWS CLI и boto3 --max-items N / PaginationConfig={"MaxItems": N} по умолчанию --starting-token T / "StartingToken": T; токен печатается в ответе как NextToken да, одно и то же понятие и те же слова
    Stripe API и SDK limit auto_paging_iter() в SDK starting_after=<id последнего> да
    gh --limit N (по умолчанию 30) gh api --paginate нет в командах высокого уровня частично
    Спецификация MCP (свои списки инструментов и ресурсов) — — непрозрачный cursor в запросе, nextCursor в ответе —

    Самый близкий к вашему принципу образец — AWS: три ручки, одинаковые на CLI и SDK, а «продолжить» — непрозрачный токен, который выдаёт сам инструмент. (Про AWS и Stripe — по страницам документации, которые читал разведчик; gh --limit 30 — по памяти, не перепроверяла.)

    Предложение: три ручки, одинаковые везде

    Ручка CLI SDK MCP
    сколько --limit N limit=N limit=N
    всё --all limit=None all=true
    продолжить --next ТОКЕН next="ТОКЕН" next="ТОКЕН"
    что вернулось сверх списка строка в stderr: «показано 500, есть ещё: --next eyJ… или --all» result.truncated, result.next приписка в ответе с тем же токеном

    Токен непрозрачный, его выдаёт ядро: внутри «с какого места продолжить» в том виде, в каком это понимает сервис (номер страницы, курсор, прокрутка Трекера). Это одно изменение в ядре, в обходе страниц; ресурсы не правятся.

    $ ycli tracker issues search --query 'Queue: DE' --limit 100
    … 100 задач …
    показано 100, есть ещё: --next eyJwIjoyfQ   (или --all)
    
    $ ycli tracker issues search --query 'Queue: DE' --limit 100 --next eyJwIjoyfQ
    

    Два места, где нужно ваше слово

    1. Умолчание. Сейчас SDK без limit отдаёт всё, CLI и MCP — 500.

    А. Везде 500 Б. Оставить: SDK — всё, CLI и MCP — 500
    Зеркало да нет
    Ломает тех, кто пишет tracker.issues.search(body) и ждёт всё да: получат 500 и truncated=True нет
    Привычно для SDK (boto3, Stripe отдают всё лениво) нет да

    Рекомендую Б, но честно названное: у SDK «всё» — это ленивый перебор (принятая идея 29), он не грузит память, поэтому умолчание «всё» там безопасно; у CLI и MCP результат печатается целиком, поэтому потолок. Это одно объяснимое различие, а не случайность. Если зеркало важнее — А.

    2. all=true в MCP. 752 задачи одним ответом — сотни тысяч знаков; клиент обрежет ответ сам. С зеркалом это честно («ручка есть везде»), а описание инструмента скажет: «большой список бери порциями через next». Рекомендую добавить, раз есть next.

    Ответ: «умолчание — А / Б; all в MCP — да / нет». Если да на всё — это вариант Б из шапки issue, только шире: три ручки на трёх поверхностях.

  3. bim-ba commented on Oct 7, 2026

    @bim-ba
    OwnerAuthor

    1 - да, согласен с тобой на вариант Б, покажи потом инлайн примеры псевдокода в сессии как будет это вызываться через разные интерфейсы (Endpoints / SDK / CLI / MCP)
    2 - да, согласен с тобой во всем

  4. bim-ba commented on Oct 7, 2026

    @bim-ba
    OwnerAuthor

    Решено (владелец, 2026-10-07)

    Три ручки, одинаковые на всех поверхностях: сколько (limit), всё (--all / limit=None / all=true), продолжить (next — непрозрачный токен, который выдаёт ядро).

    • Умолчание — Б: SDK без limit отдаёт всё ленивым перебором; CLI и MCP — 500. Это одно объяснимое различие: SDK не печатает результат целиком.
    • all=true в MCP — да; описание инструмента советует брать большой список порциями через next.
    • Об обрыве сообщают все три: result.truncated / result.next в SDK, строка в stderr у CLI, приписка с токеном у MCP.

    Одно изменение в ядре, в обходе страниц; ресурсы не правятся.

  5. bim-ba commented on Oct 7, 2026

    @bim-ba
    OwnerAuthor

    Поправка к «у 8 операций метод SDK шире инструмента» (E5 перемерила по всем 467 операциям). Формулировка была неверной: это не разрыв между CLI и MCP. Команда и инструмент передают все параметры метода у 447 операций; у 14 инструмента нет вовсе (файлы); у 6 параметр метода не передаёт ни команда, ни инструмент — то есть CLI и MCP зеркальны везде, а SDK в шести местах шире обеих. Из «восьми» две не разрыв вовсе. Пять операций получают аргумент на обеих поверхностях (PR #511: tracker entities comments list|get --expand, links list --fields, wiki pages descendants-list|-by-id --actuality); шестая, tracker.entities.search (page, per_page), ждёт единой пагинации из этого решения. Проверка, которая это пропускала, сравнивала только набор операций, а аргументы — нет; теперь сравнивает.

  6. bim-ba commented on Oct 8, 2026

    @bim-ba
    OwnerAuthor

    Уточнение решением в #538 (6 — Б, 2026-10-08): в CLI -o json и -o yaml печатают тот же объект {items, truncated, next, total}, что отдают MCP и SDK, а не массив; табличные форматы печатают строки, обрыв — строкой в stderr, как и было.

  7. bim-ba commented on Oct 10, 2026

    @bim-ba
    OwnerAuthor

    Построено и лежит в main: три ручки на всех списках, обрыв и объект {items, truncated, next, total} — #534; лимит по умолчанию для MCP 50 — #566; токен второй версии — #567. Закрываю.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions