← Каталог

· AI Engineer Code 2025

Ваш MCP-сервер плох — и вам должно быть стыдно

Your MCP Server is Bad and You Should Feel Bad

MCP-сервер стоит проектировать как продукт для агента, а не как обёртку над REST API: меньше инструментов, готовые результаты и плоские аргументы.

  • Результат вместо операций — инструмент должен закрывать задачу агента целиком, например «последний заказ по email», а не набор атомарных вызовов. Склейку нескольких вызовов лучше делать в коде сервера: по словам спикера, оркестрация через LLM дорогая, медленная и трудно отлаживается.
  • Плоские аргументы и понятные ошибки — вместо dict передавайте примитивы, для выбора из набора используйте Literal или enum. Текст ошибки попадает в контекст агента как следующая подсказка, поэтому в нём стоит написать, как исправить вызов.
  • Бюджет контекста — при 200 тысячах токенов и 800 эндпоинтах на каждый инструмент остаётся меньше 250 токенов. По мнению спикера, около 50 инструментов на агента уже дают деградацию, поэтому конвертированный REST API в продакшен выкатывать не стоит.
  • Клиенты ведут себя по-разному — Claude Desktop кэширует инструменты в SQLite и игнорирует часть механизмов спецификации. Автоконвертер FastMCP из REST API спикер советует использовать только для старта, а потом урезать сервер.

Кому полезно: тем, кто пишет MCP-серверы для внешних клиентов, которые не контролируют.

Доклад цитируется в статьях

Главы

Ещё доклады: Jeremiah Lowin

Страница спикера →

Похожие доклады