NextPDF Connect
NextPDF Connect
NextPDF Connect 是 nextpdf/server 套件：一個長時間執行的服務，會將 NextPDF PDF 2.0 引擎開放給 AI Agent（代理）與超文字傳輸協定（HTTP）用戶端使用。同一份工具登錄表會透過三種方式提供：以標準輸入與輸出承載的模型情境協定（Model Context Protocol，MCP）、由 OpenAPI 3.1 文件描述的具象狀態傳輸（REST）應用程式介面（API），以及由 nextpdf.connect.v1 Protocol Buffers 套件定義的 gRPC。每個工具都會宣告一個風險等級。最高等級在執行前，會先經過一道人工介入（HITL）確認 gate。
本節內容可協助你維運或整合這個伺服器。請先閱讀概覽了解架構，再選擇一種傳輸方式，然後閱讀 API 參考查閱確切的工具與服務符號。
章節地圖
標題為「章節地圖」的區段下列頁面涵蓋伺服器的概念、組態與維運。
| 頁面 | 用途 |
|---|---|
| 概覽 | 套件邊界、三種傳輸方式，以及為何工具數量是一項執行期屬性。 |
| 快速上手 | 一個可實際執行的首次 MCP 交握範例，以及對應的 REST 繪製請求。 |
| 組態 | MCP 的 YAML 檔、NEXTPDF_* 環境變數，以及只能升級的風險覆寫。 |
| 啟動與探索 | 每一種傳輸方式如何接上各自的伺服器，並在啟動時探索工具與層級。 |
| 工具目錄 | 已驗證且永遠可用的核心工具集，以及總數如何在執行期計算出來。 |
| HITL 風險層級 | 四級風險模型，以及需核准工具對應的確認挑戰。 |
| 部署 | RoadRunner worker 設定檔、Docker、以 Redis 作為後盾的儲存區，以及 gRPC 的雙向傳輸層安全（TLS）。 |
| 安全性與維運 | 驗證模型、傳輸安全、威脅模型，以及資料落地（data residency）處置。 |
這三種傳輸方式各有專屬參考頁面。
| 傳輸頁面 | 用途 |
|---|---|
| MCP 傳輸 | 以 stdio 承載的 JavaScript 物件標記法遠端程序呼叫（JSON-RPC）2.0 訊息 Framework（框架），以及 initialize / tools/list / tools/call 方法。 |
| REST 傳輸 | RoadRunner 的 PSR-15 管線、OpenAPI 3.1 合約、bearer 驗證，以及依層級把關的路由。 |
| gRPC 傳輸 | 提供 nextpdf.connect.v1.NextPDFConnect 服務、伺服器串流 RPC，以及中繼資料驗證。 |
主要 API
標題為「主要 API」的區段這兩個頁面是開發者針對此伺服器進行開發的入口。
| 頁面 | 角色 |
|---|---|
| API 參考 | 依名稱與類別列出每個已註冊的工具、gRPC 服務與訊息符號、錯誤模型，以及速率限制。 |
| 開發者指南 | 架構邊界、執行期生命週期、層級 resolve（解析）、確認 gate、擴充點，以及測試檢查清單。 |