NextPDF Connect
NextPDF Connect
NextPDF Connect は nextpdf/server パッケージです。NextPDF PDF 2.0 エンジンを人工知能（AI）エージェントおよびハイパーテキスト転送プロトコル（HTTP）クライアントに公開する、長期稼働型のサービスです。同じツールレジストリを 3 つの方法で提供します。標準入出力を介した Model Context Protocol（MCP）、OpenAPI 3.1 ドキュメントで記述される Representational State Transfer（REST）Application Programming Interface（API）、そして nextpdf.connect.v1 Protocol Buffers パッケージで定義される gRPC です。すべてのツールはリスクレベルを宣言します。最上位レベルのツールは、実行前に human-in-the-loop（HITL）の確認ゲートを通過します。
サーバーを運用または統合するときは、このセクションを参照してください。まずアーキテクチャについて 概要 を読み、次にトランスポートを選択し、その後、正確なツールおよびサービスのシンボルを確認するために API リファレンス を参照してください。
セクションマップ
「セクションマップ」という見出しのセクションこれらのページでは、サーバーの概念、構成、運用を扱います。
| ページ | 用途 |
|---|---|
| 概要 | パッケージ境界、3 つのトランスポート、ツール数がランタイムのプロパティである理由。 |
| クイックスタート | 最初に実行できる MCP ハンドシェイクと、それに相当する REST レンダリングリクエスト。 |
| 構成 | MCP YAML ファイル、NEXTPDF_* 環境変数、アップグレード専用のリスクオーバーライド。 |
| 起動とディスカバリー | 各トランスポートがサーバーに接続され、起動時にツールとティアを検出する仕組み。 |
| ツールカタログ | 検証済みで常時利用可能なコアツールセットと、合計数がランタイムで計算される仕組み。 |
| HITL リスクティア | 4 段階のリスクモデルと、承認が必要なツールに対する確認チャレンジ。 |
| デプロイ | RoadRunner のワーカープロファイル、Docker、Redis ベースのストア、gRPC の相互 Transport Layer Security（TLS）。 |
| セキュリティと運用 | 認証モデル、トランスポートセキュリティ、脅威モデル、データレジデンシー方針。 |
3 つのトランスポートには、それぞれ専用のリファレンスページがあります。
| トランスポートページ | 用途 |
|---|---|
| MCP トランスポート | stdio 上の JavaScript Object Notation Remote Procedure Call（JSON-RPC）2.0 フレーミングと、initialize / tools/list / tools/call メソッド。 |
| REST トランスポート | RoadRunner の PSR-15 パイプライン、OpenAPI 3.1 コントラクト、ベアラー認証、ティアでゲートされるルート。 |
| gRPC トランスポート | nextpdf.connect.v1.NextPDFConnect サービス、サーバーストリーミング RPC、メタデータ認証。 |
主要な API
「主要な API」という見出しのセクションこれらの 2 つのページは、サーバーを利用して開発する開発者向けのエントリーポイントです。
| ページ | 役割 |
|---|---|
| API リファレンス | 名前とクラス別に登録されたすべてのツール、gRPC サービスおよびメッセージのシンボル、エラーモデル、レート制限。 |
| 開発者ガイド | アーキテクチャ境界、ランタイムのライフサイクル、ティアの resolve（解決）、確認ゲート、拡張ポイント、テストのチェックリスト。 |
- 概要 — パッケージ概念のエントリーポイント
- API リファレンス — 正確なツール、RPC、メッセージのシンボル
- 開発者ガイド — サーバーの構築、拡張、運用方法
- セキュリティと運用 — 認証と脅威モデル