NextPDF Connect のインストール

概要

Composer で nextpdf/server をインストールします。その後、3 つあるトランスポート用エントリポイントのいずれかを実行します。コアのインストールに必要なのは PHP 8.4 と NextPDF エンジンのみです。Redis と Premium はオプションです。

インストール

composer require nextpdf/server

このコマンドは nextpdf/core: ^3.0 を依存関係として取り込みます。このパッケージは php: >=8.4 <9.0 を宣言しているため、Composer は PHP 8.3 以下または PHP 9 へのインストールを拒否します。

概念の概要

このパッケージは Composer の library 型パッケージです。インストールすると、vendor/bin/ に 4 つのコンソールエントリポイントが追加されます。

vendor/bin/nextpdf-mcp — MCP stdio サーバー。
vendor/bin/nextpdf-server — REST サーバー（RoadRunner HTTP ワーカー）。
vendor/bin/nextpdf-grpc — gRPC サーバー（RoadRunner gRPC ワーカー）。
vendor/bin/generate-skills — ツールカタログをエージェントスキルとしてエクスポートします。

5 つ目のスクリプト bin/nextpdf-prune は、メンテナンスタスク用としてリポジトリに同梱されています。これは vendor/bin/ 経由ではなく、直接実行します。

サービスプロバイダー、バンドル、フレームワークへの登録は一切不要です。このサーバーはスタンドアロンプロセスです。ホストアプリケーションに組み込むライブラリではありません。

API サーフェス

Composer は、パッケージのランタイム依存関係もインストールします。これらの推移的依存関係には、HTTP と gRPC のスタックが含まれます。

league/route と nyholm/psr7 — REST ルーティングと PSR-7 メッセージ。
spiral/roadrunner-http と spiral/roadrunner-grpc — REST および gRPC トランスポート向けの RoadRunner ワーカーランタイム。
psr/http-server-middleware と psr/http-server-handler — REST パイプラインが実装する PSR-15 ミドルウェアコントラクト。
symfony/yaml — 構成ファイルの解析。
ramsey/uuid — リクエストおよびリソースの識別子。

これらを直接インストールする必要はありません。Composer が nextpdf/server から解決します。

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

インストールを確認するには、サーバーを起動せずにツールカタログを一覧表示します。

./vendor/bin/generate-skills --dry-run --list-tools

このコマンドはレジストリを起動し、ティア検出を実行して、このインストールが公開しているツールを出力します。この一覧には、どのオプションパッケージが存在するかが反映されます。詳しくは /connect/tool-catalog/ を参照してください。

コードサンプル — 本番環境

本番環境のインストールでは、依存関係を固定し、開発用ツールはスキップします。

composer require nextpdf/server --no-dev
composer install --no-dev --optimize-autoloader --classmap-authoritative

REST および gRPC トランスポートでは、RoadRunner バイナリもあわせてインストールします。RoadRunner は、ワーカープールを管理するプロセススーパーバイザーです。PHP パッケージが提供するのはワーカーであり、スーパーバイザーではありません。

./vendor/bin/rr get-binary

エッジケースと注意点

オプションの Redis。 ext-redis 拡張モジュールは suggest であり、require ではありません。これがない場合、REST サーバーはレート制限、冪等性、ドキュメントストアにインメモリストアを使用します。これらのインメモリストアは単一ワーカーでは正しく機能しますが、複数ワーカーのプール間では共有されません。複数ワーカーのデプロイでは、ext-redis をインストールし、Redis の環境変数を設定してください。詳しくは /connect/configuration/ を参照してください。
オプションの Premium。 nextpdf/premium は suggest です。これをサーバーと一緒にインストールすると、レジストリのティア検出プローブが該当するプロバイダークラスを検出します。その後、プローブが追加の Pro ツールと Enterprise ツールを登録します。これがない場合は、コアカタログのみが提供されます。これは composer require の時点で行われるパッケージング上の決定であり、ランタイムのトグルではありません。
MCP サーバーに RoadRunner は不要です。 nextpdf-mcp は、stdio 経由で JSON-RPC を使用するシンプルな PHP プロセスです。RoadRunner が必要なのは、REST および gRPC トランスポートの場合のみです。

パフォーマンス

インストール時のコストの大部分は、Composer の依存関係解決が占めます。本番イメージでは、コールドブート時のオートロード時間を短く保つために、--prefer-dist と authoritative なクラスマップを使用します。サーバー自体の起動コストは、レジストリのスキャンとティア検出です。このページの performance_budget は、その起動コストの上限を定めています。

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

公式の Packagist パッケージ nextpdf/server からのみインストールしてください。デプロイされるツールカタログを再現可能にするため、composer.json でバージョンを固定し、composer.lock をコミットしてください。ネットワークトランスポートは、ヘルスチェック以外のエンドポイントを提供する前に API キーを要求します。詳しくは /connect/security-and-operations/ を参照してください。

準拠

このページでは、インストールの仕組みのみを説明します。プロトコルとセキュリティの準拠に関する出典は、/transports/mcp/、/transports/rest/、/transports/grpc/、および /connect/security-and-operations/ に固定されています。

商用コンテキスト

コアのインストールだけで完全に機能します。3 つすべてのトランスポートで、ドキュメントの作成、検査、診断を処理します。nextpdf/premium を追加すると、トランスポートや認証モデルを変更することなくカタログが拡張されます。