pdfops-mcp

pdfops-mcp

PDFops APIを利用する、AI エージェントに決定論的な PDF ツールを提供する MCP サーバーです。AcroForm フィールドの検査、フォームの入力、PDF の結合、請求書の生成に対応しています。Chromium もネイティブ依存関係も不要で、ホストするものもありません。

ローカルエージェントでは、ツールはファイルパスを使うため、PDF のバイトデータがモデルコンテキストを通過することはありません。エージェントが 「/tmp/form.pdf に入力して /tmp/out.pdf に保存して」 と指示すると、1 行の確認が返されます。すべての PDF 入力には https:// URL または data:application/pdf;base64,… URI も指定でき、すべての出力はファイルに書き込まずインラインで返すこともできます。これにより、ホスト型ランタイムでもサーバーを利用できます（下記参照）。

インストール

Claude Code

claude mcp add pdfops -- npx -y pdfops-mcp
# with a key:
claude mcp add pdfops -e PDFOPS_API_KEY=pdfops_live_… -- npx -y pdfops-mcp

Claude Desktop（claude_desktop_config.json）／Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "pdfops": {
      "command": "npx",
      "args": ["-y", "pdfops-mcp"],
      "env": { "PDFOPS_API_KEY": "pdfops_live_…" }
    }
  }
}

VS Code（.vscode/mcp.json。servers キーと type に注意）

{
  "servers": {
    "pdfops": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pdfops-mcp"],
      "env": { "PDFOPS_API_KEY": "pdfops_live_…" }
    }
  }
}

その他の stdio クライアント（Windsurf、Cline、Zed、独自のエージェントなど）では、コマンドに npx、引数に -y pdfops-mcp を指定してください。クライアントごとの手順と実際のツール呼び出しの記録は、pdfops.dev/mcpをご覧ください。

PDFOPS_API_KEY は任意です。設定しない場合は、キー不要のトライアル（月間 100 リクエスト／IP）を利用できます。無料キー（月間 250 リクエスト、カード登録不要）は、pdfops.dev/pricingでメールアドレスを入力すると取得できます。

ツール

ツール	機能
pdf_inspect	PDF のフォームフィールド（名前、種類、選択肢、値）と、そのまま貼り付けて使える入力テンプレートを一覧表示します。不慣れな PDF では最初に呼び出してください。
pdf_fill	AcroForm フィールドに入力し、入力済み PDF を書き込みます。任意の flatten を指定すると、値を PDF に焼き込み、フォームを削除します。
pdf_merge	2 つ以上の PDF を指定順に結合し、結果を書き込みます。
pdf_invoice	構造化データから請求書 PDF を生成します。決定論的な処理により、同じ入力からバイト単位で同一の出力が生成されます。
pdfops_usage	設定されているキーの利用枠を確認します。

ホスト型エンドポイント（インストール不要）

PDFops では、このサーバーを https://pdfops.dev/api/mcp（Streamable HTTP）で実行しています。キーなしでも利用できます（月間 100 回／IP のキー不要トライアル上限）。https://pdfops.dev/pricing#free-keyで取得できる無料キーを使うと、上限が増えます。

claude mcp add --transport http pdfops https://pdfops.dev/api/mcp
# with a key:
claude mcp add --transport http pdfops https://pdfops.dev/api/mcp --header "Authorization: Bearer $PDFOPS_API_KEY"

ソースには https:// URL または data: URI を指定し、結果はインラインで返されます。Cursor と VS Code の設定方法は、https://pdfops.dev/mcp#remoteをご覧ください。

リモート実行（Smithery、Glama ホスト型、クラウド IDE ゲートウェイ）

ホスト型 MCP ランタイムでは、エージェントのファイルパスが存在しないマシン上でこのサーバーが実行されます。設定は変更せず、サーバーがアクセスできるソースを渡し、output_path を省略してください。

• 入力（pdf_path、pdf_paths）：サーバーが取得できる https:// URL（PDF ごとに 4 MB 以下、リクエストごとに 4.5 MB 以下。API の制限）、または小さなファイル用の data:application/pdf;base64,… URI。
• 出力：output_path を省略すると、pdf_fill／pdf_merge／pdf_invoice は PDF を埋め込み application/pdf リソース（pdfops://filled.pdf など）としてインラインで返し、クライアントが保存します。output_path を指定すると、サーバーが実行されている場所にファイルが書き込まれます。

ローカルでは、これまでどおり絶対パスを使用できます。これが引き続き推奨される形式です。バイトデータがモデルコンテキストに入ることもありません。

プロンプトの例

• 「~/forms/fw9.pdf にはどのようなフィールドがありますか？」 → pdf_inspect
• 「~/forms/fw9.pdf に Ada Lovelace、12 Analytical Way、London の情報を入力し、フラット化して ~/out/w9-ada.pdf に保存して」 → pdf_inspect、続いて flatten: true を指定して pdf_fill
• 「onboarding form に contractors.csv の各行を使って入力し、~/out/ に保存して」 → pdf_inspect を 1 回実行し、その後、各行について pdf_fill
• 「/out/w9-ada.pdf、/docs/nda.pdf、~/docs/cover.pdf を、cover を先頭にして 1 つの書類一式にまとめて」 → pdf_merge
• 「Globex 宛てに、1 日 650 ドルのコンサルティング 3 日分、税率 8.5%、支払期限 30 日の請求書を作成して」 → pdf_invoice
• 「今月、PDFops のリクエストはあと何回使えますか？」 → pdfops_usage

エージェントの実行例

「/docs/w9.pdf の W-9 テンプレートに Ada Lovelace の情報を入力し、/docs/cover.pdf と結合して」

1. pdf_inspect → フィールド名と入力テンプレートを確認します
2. pdf_fill → 入力済みの W-9 を書き込みます
3. pdf_merge → 結合した書類一式を書き込みます

リンク

API ドキュメント：pdfops.dev/docs · OpenAPI：pdfops.dev/openapi.json · 型付きクライアント：pdfops-sdk · お問い合わせ：[email protected]

プライバシーポリシー

このサーバーはお使いのマシン上で動作し、PDFops API（https://pdfops.dev）にはツールの呼び出しに必要な情報のみを送信します。具体的には、指定した PDF のバイトデータ、入力したフィールド値、設定している場合は API キーです。PDFops はリクエストをメモリ上で処理して結果を返し、お客様のドキュメントを保存しません。API リクエストは、利用上限の管理とサービスの運用のため、利用状況のメタデータとともにログに記録されます。ポリシー全文は https://pdfops.dev/privacy をご覧ください。お問い合わせ：[email protected]。

MIT © PDFops