NextPDF Connect
NextPDF Connect
Краткий обзор
Заголовок раздела «Краткий обзор»NextPDF Connect — пакет nextpdf/server. Он работает как долгоживущий сервис и предоставляет движок NextPDF PDF 2.0 агентам искусственного интеллекта (AI) и клиентам Hypertext Transfer Protocol (HTTP). Один и тот же реестр инструментов доступен через три транспорта: Model Context Protocol (MCP) поверх стандартных ввода и вывода, Representational State Transfer (REST) Application Programming Interface (API), описанный документом OpenAPI 3.1, и gRPC, определяемый пакетом Protocol Buffers nextpdf.connect.v1. Каждый инструмент объявляет свой уровень риска. Инструменты самого высокого уровня перед выполнением должны пройти контрольный этап подтверждения с участием человека (human-in-the-loop, HITL).
Используйте этот раздел при эксплуатации или интеграции сервера. Начните с раздела Обзор, чтобы разобраться в архитектуре; затем выберите транспорт и используйте Справочник по API для точных символов инструментов и сервисов.
Карта раздела
Заголовок раздела «Карта раздела»На этих страницах описаны концепции, настройка и эксплуатация сервера.
| Страница | Назначение |
|---|---|
| Обзор | Граница пакета, три транспорта и причины, по которым количество инструментов является свойством среды выполнения. |
| Быстрый старт | Готовое к запуску первое рукопожатие MCP и соответствующий REST-запрос на отрисовку. |
| Настройка | YAML-файл для MCP, переменные окружения NEXTPDF_* и переопределение риска, которое работает только на повышение. |
| Загрузка и обнаружение | Как каждый транспорт подключает свой сервер и при загрузке обнаруживает инструменты и уровни. |
| Каталог инструментов | Проверенный, всегда доступный набор основных инструментов и то, как среда выполнения вычисляет их общее количество. |
| Уровни риска HITL | Четырёхуровневая модель риска и запрос подтверждения для инструментов, требующих одобрения. |
| Развёртывание | Профили рабочих процессов RoadRunner, Docker, хранилища на базе Redis и взаимный Transport Layer Security (TLS) для gRPC. |
| Безопасность и эксплуатация | Аутентификация, безопасность транспорта, модель угроз и подход к резидентности данных. |
Для каждого транспорта есть отдельная справочная страница.
| Страница транспорта | Назначение |
|---|---|
| Транспорт MCP | Фрейминг JavaScript Object Notation Remote Procedure Call (JSON-RPC) 2.0 поверх stdio, а также методы initialize / tools/list / tools/call. |
| Транспорт REST | PSR-15-конвейер RoadRunner, контракт OpenAPI 3.1, bearer-аутентификация и маршруты с контролем по уровню. |
| Транспорт gRPC | Сервис nextpdf.connect.v1.NextPDFConnect, серверные потоковые RPC и аутентификация через метаданные. |
Основные API
Заголовок раздела «Основные API»Используйте эти две страницы при разработке под сервер.
| Страница | Роль |
|---|---|
| Справочник по API | Каждый зарегистрированный инструмент с именем и классом, символы сервиса и сообщений gRPC, модель ошибок и ограничения частоты запросов. |
| Руководство разработчика | Архитектурная граница, жизненный цикл среды выполнения, определение уровня, контрольный этап подтверждения, точки расширения и контрольный список тестирования. |
См. также
Заголовок раздела «См. также»- Обзор — концептуальная отправная точка по пакету
- Справочник по API — точные символы инструментов, RPC и сообщений
- Руководство разработчика — как создавать, расширять и эксплуатировать сервер
- Безопасность и эксплуатация — аутентификация и модель угроз