Papyrio PDF Tools

papyrio-mcp

Papyrio PDF API 用の MCP サーバーです。Claude、Cursor、VS Code 向けのセットアップについては、papyrio.net/mcp をご覧ください。アシスタントがご自身のマシン上で PDF を圧縮、結合、OCR、変換できます。ローカルファイルを読み書きするため、複数ステップの作業でも、各ステップごとにアップロードとダウンロードを繰り返す必要はありません。

OCR every scan in ~/invoices, merge them into one PDF, compress it under 5 MB

は、アシスタントが自ら行う 4 回のツール呼び出しです。

インストール

Claude Desktop にワンクリックでインストール

papyrio-mcp.mcpb をダウンロード してダブルクリックします。Claude Desktop にインストール画面が表示されます。無料のゲスト枠を使う場合は API キーを空欄のままにするか、RapidAPI キーを貼り付けてください（詳細は以下をご覧ください）。後から Settings の Extensions で変更できます。

手動で、またはほかのクライアントにインストール

Claude Desktop の設定に以下を追加します。

macOS ~/Library/Application Support/Claude/claude_desktop_config.json Windows %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "papyrio": {
      "command": "npx",
      "args": ["-y", "papyrio-mcp"]
    }
  }
}

Claude Desktop を再起動します。コネクターアイコンの下にツールが表示されます。

API キー

API キーなしでもサーバーを利用できます。通常の無料ウェブトラフィックとして計測され、IP アドレスごとに 1 日 3 回まで操作できます。役に立つかどうかを確かめるには十分です。

本格的に利用する場合は、 RapidAPI に登録し、キーを渡してください。

{
  "mcpServers": {
    "papyrio": {
      "command": "npx",
      "args": ["-y", "papyrio-mcp"],
      "env": { "PAPYRIO_API_KEY": "your-rapidapi-key" }
    }
  }
}

RapidAPI の無料枠は月 50 リクエストで、クレジットカードは不要です。

ツール

ツール	機能	書き込むファイル
compress_pdf	PDF を圧縮します。画像の多いファイルでは 30～80％縮小します	.pdf
merge_pdfs	2～10 個の PDF を順番どおりに結合します	.pdf
split_pdf	各ページを個別のファイルに分割します	.zip
extract_pdf_text	テキストレイヤーを UTF-8 で返します	.txt
pdf_to_word	文書を編集可能な .docx として再構成します	.docx
pdf_to_jpg	すべてのページを JPG としてレンダリングします	.zip
ocr_pdf	スキャン画像に検索可能なテキストレイヤーを追加します。lang で英語、ロシア語、スペイン語、イタリア語、ウズベク語、カザフ語を選択します	.pdf
office_to_pdf	Word、PowerPoint、Excel を PDF に変換します	.pdf
image_to_pdf	JPG、PNG、WebP を PDF ページに変換します	.pdf
webpage_to_pdf	ヘッドレスブラウザーで公開 URL をレンダリングします	.pdf
protect_pdf	AES-256 で暗号化します	.pdf
unlock_pdf	既知のパスワードを削除します	.pdf

すべてのツールで絶対パスを指定します。output_path は省略可能で、省略した場合は入力ファイル名に -papyrio を付けた名前が使われます。ただし webpage_to_pdf は名前の元になる入力ファイルがないため、指定が必須です。

ツールの追加

src/tools.ts にエントリーを追加します。MCP ツール、その入力スキーマ、HTTP 呼び出しは、すべてそこから生成されます。

テスト

npm run build
PAPYRIO_API_KEY=your-key node smoke.mjs

実際の MCP プロトコルを介して、稼働中の API に対して 12 個すべてのツールを実行し、返されたファイルのマジックバイトを確認します。そのため、.pdf という名前の JSON エラー本文は成功ではなく失敗として判定されます。キーなしの場合はゲスト枠で実行されますが、1 日 3 回までのため、ほとんどのケースで rate_limit_exceeded が発生します。

開発

npm install
npm run build

開発中は、設定でローカルビルドを指定してください。

{
  "mcpServers": {
    "papyrio": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/dist/index.js"]
    }
  }
}

プライバシー：ファイルは Papyrio API に送信され、メモリー上で処理された後、応答の送信時に破棄されます。保存されることはありません。

ライセンス

MIT