NextPDF Connect サーバー概要

概要

NextPDF Connect は nextpdf/server パッケージとして提供される、長時間稼働型のサービスです。NextPDF PDF 2.0 エンジンを AI エージェントおよび HTTP クライアントに公開します。公開経路は 3 つのトランスポート、すなわち stdio 上の Model Context Protocol（MCP）、REST API、gRPC です。3 つのトランスポートはいずれも、1 つのツールレジストリと 1 つの human-in-the-loop（HITL）確認ゲートの背後に配置されます。

インストール

composer require nextpdf/server

Composer の制約は nextpdf/core: ^3.0 および php: >=8.4 <9.0 です。インストール手順の全体は、/connect/install/. を参照してください。そのページでは、オプションのアドオンである ext-redis 拡張モジュールと nextpdf/premium パッケージの 2 つについても説明しています。

概念の概要

nextpdf/server は、フレームワークに依存しない NextPDF コアを、サービスとして提供できる形に適合させます。PDF 生成機能を作り直すものではありません。代わりに、各エンジン機能を専用スキーマを持つ名前付きツールとしてラップし、そのカタログを複数のワイヤープロトコルで提供します。

この設計は、全体として 3 つの概念で構成されています。

ツールレジストリ。 NextPDF\Server\ToolRegistry は起動時にツールを検出して登録します。コアセットはパッケージに同梱され、常に利用できます。Pro および Enterprise のプロバイダーはさらに多くのツールを登録しますが、それぞれ対応するパッケージがインストールされている場合に限ります。したがって、公開されるツールの数は固定された定数ではなく、デプロイ環境のランタイム特性です。/connect/tool-catalog/. を参照してください。
トランスポート。 同じレジストリは 3 通りの方法で提供されます。MCP は、ローカルの AI クライアント向けに stdio 上で動作します。REST は、ネットワーク経由のクライアント向けに、RoadRunner ワーカープール上の PSR-15 ミドルウェアパイプラインで動作します。gRPC は、型付きクライアントまたはストリーミングクライアント向けに、Spiral RoadRunner gRPC ワーカー上で動作します。各トランスポートは、独自のエントリポイントを持つ独立したプロセスです。/transports/mcp/、/transports/rest/、/transports/grpc/. を参照してください。
確認ゲート。 すべてのツールはリスクレベルを宣言します。最高レベルのツールは、実行前に人間による明示的な確認を必要とします。ゲートは、1 回限り使用できるチャレンジトークンを発行します。エージェントはそのトークンを人間に渡し、同じトークンを使って再度ツールを呼び出す必要があります。/connect/hitl-risk-tiers/. を参照してください。

以下の図は、1 つのレジストリが 3 つのトランスポートへどのようにつながるかを示しています。また、確認ゲートがリクエスト経路のどこに位置するかも示しています。

NextPDF Connect component architecture

このパッケージのライセンスは Apache-2.0 で、nextpdf/core と一致します。実装されている MCP プロトコルのバージョンは、日付ベースでバージョン管理された 2025-06-18 リビジョンです。OpenAPI 3.1 ドキュメントは REST 面を記述しています。nextpdf.connect.v1 Protocol Buffers パッケージは gRPC 面を記述しています。

API 面

公開されているエントリポイントは、3 つのサーバークラスです。それぞれにコマンドラインインターフェイス（CLI）ラッパーがあります。

エントリポイント	クラス	トランスポート
`bin/nextpdf-mcp`	`NextPDF\Server\Mcp\McpServer`	stdio 上の MCP
`bin/nextpdf-server`	`NextPDF\Server\Http\HttpServer`	RoadRunner HTTP 上の REST
`bin/nextpdf-grpc`	`NextPDF\Server\Grpc\GrpcServer`	RoadRunner gRPC 上の gRPC
`bin/generate-skills`	`NextPDF\Server\Skills\SkillsDumper`	ツールカタログのエクスポート

McpServer::create()、HttpServer::create()、GrpcServer::create() はそれぞれ、環境および構成の入力から完全に構成されたサーバーを構築します。レジストリ、ドキュメントストア、セキュリティポリシー、確認ゲートは、3 つのサーバーすべてで共有される概念です。

コードサンプル — クイックスタート

最小構成の MCP サーバーは 1 つのコマンドで起動できます。PHP のグルーコードを記述する必要はありません。

./vendor/bin/nextpdf-mcp

サーバーは標準入力から JSON-RPC リクエストを読み取り、標準出力にレスポンスを書き込みます。実際に実行できる initialize と tools/list のやり取り、および対応する REST リクエストについては、/connect/quickstart/. を参照してください。

エッジケースと注意点

ツールの数は 33 でも、その他の固定された数でもありません。 サーバーは、ポリシーによるフィルタリングとティア検出の後に、ランタイムで count(ToolRegistry::all()) としてツールを数えます。固定の合計数を記載しているドキュメントは古くなっています。正確な数を取得するには、稼働中のサーバーに問い合わせてください。MCP の initialize レスポンス、または REST の /api/v1/capabilities エンドポイントを使用してください。

公開されるツールの数は、インストールされているパッケージと有効なポリシーに依存します。ランタイムに稼働中のサーバーから読み取ってください。独自のコードやドキュメントにコピーした固定の数値は、いずれ古くなります。
Pro または Enterprise パッケージが存在しないことはエラーではありません。 レジストリは class_exists() でプロバイダークラスを確認し、存在しないティアは静かにスキップします。オープンソースのみのデプロイ環境は、通常どおり起動してコアカタログを提供します。
3 つのトランスポートはプロセスを共有しません。 MCP サーバーを実行しても、REST サーバーや gRPC サーバーは起動しません。逆も同様です。統合デプロイ環境では、HTTP と gRPC の両方のワーカープールを起動する構成で RoadRunner スーパーバイザーを実行します。/connect/deployment/. を参照してください。

パフォーマンス

各トランスポートはワーカーベースです。1 つのワーカーは一度に 1 つのリクエストを処理します。REST サーバーと gRPC サーバーは RoadRunner ワーカープール上で実行され、プールサイズは構成で設定します。デフォルトは 4 つの HTTP ワーカーです。RoadRunner スーパーバイザーは、各ワーカーのメモリに上限を設けます。このページの performance_budget フロントマターは、コールドブートと検出に関する性能エンベロープを記述したものです。これはリクエストごとの目標値ではありません。各リクエストのコストの大部分は、基盤となるエンジンの処理が占めます。

セキュリティに関する注意事項

ネットワーク経由のすべてのトランスポートは、アプリケーションプログラミングインターフェイス（API）キーをベアラートークンとして使用して認証します。MCP stdio トランスポートは、MCP トランスポートモデルに従って、起動したクライアントが信頼するローカルのサブプロセスです。高リスクのツールは、すべてのトランスポートで人間による確認ゲートの背後に置かれたままになります。脅威モデル、認証モデル、トランスポートセキュリティ構成の全体については、/connect/security-and-operations/. を参照してください。

準拠

このページはアーキテクチャに関する主張のみを扱います。規範的なプロトコルおよびセキュリティの引用は、その動作を規定するページに固定されています。/connect/security-and-operations/、/transports/mcp/、/transports/rest/、/transports/grpc/. MCP ライフサイクルのリファレンスは、modelcontextprotocol.io（リビジョン 2025-06-18）にある公式仕様です。MCP 仕様はゲート付き標準コーパスの一部ではないため、トランスポートの各ページではそのリファレンスを URL とともに記録しています。

商用に関する補足

コアカタログは、ドキュメントの作成、検査、診断のために完備されています。署名、墨消し、コンプライアンス認証、フォレンジック分析のためのツールは、nextpdf/premium がサーバーとともにインストールされている場合にのみ表示されます。これはパッケージング上の境界であり、ランタイムでのアップセル表示ではありません。サーバーがマーケティングコンテンツを出力することは一切ありません。