What is docfy-mcp

Что это такое

docfy-mcp — это сервер MCP (Model Context Protocol). Он отдаёт каталог OpenAPI (лучше всего тот, что уже описан через nestjs-docfy, но подойдёт любая корректная спецификация OpenAPI 3.0/3.1) как инструменты, которые подключённый кодовый агент вызывает напрямую.

Инструментов пять: list_endpoints и get_endpoint для поиска и разбора эндпоинтов, lint_spec для проверки качества спецификации, diff_specs для сравнения с другой версией и contract_test для проверки живого сервера на соответствие спецификации.

Зачем он нужен

Без него у агента, который пишет клиент к вашему API, есть два пути: угадать структуру по контексту либо попросить человека открыть браузер, найти Swagger UI и вставить нужный кусок обратно в чат. Оба медленнее и менее надёжны, чем прямой вызов инструмента.

Как это связано с nestjs-docfy

docfy-mcp построен на том же движке модели документа, которым пользуется docfy-ui: на общем пакете docfy-core.

Результат get_endpoint — это в точности тот же текст, который копирует кнопка Copy for AI в docfy-ui, и собирает его та же функция operationToAiText(). Оба проекта — это два разных фронтенда к одной модели: один для человека в браузере, другой для агента поверх stdio.