TruePath PDF

TruePath PDF — MCP サーバー

AI で PDF をローカル処理できます。ファイルが Mac から外部に送信されることはありません。

@truepathpdf/mcp-server は、Claude、Cursor、その他の MCP 対応クライアントが、どこにもアップロードすることなく、マシン上の PDF ファイルを読み取り、処理できるようにする Model Context Protocol サーバーです。

TruePath PDF Mac アプリを開発・保守するチームである Joy Truepath Pte. Ltd. が開発・保守しています。

ステータス

v0.3 — 無料ティアが完成（9 個のツール中 9 個）。 読み取り＋編集＋ラスタライズ＋GUI への引き渡し：get_info、extract_text、search、split、merge、pages、to_images、extract_images、open_in_truepath。Pro ティア全機能（redact、fill_form、flatten、sign、compress、annotate、autocrop、batch、ocr）は、v0.4 で Ed25519 ライセンスキーによる制限付きで提供予定です。

open_in_truepath を使用するには、TruePath PDF Mac アプリ v1.0.1 以降が必要です（truepath:// ハンドラーは 1.0.1 で追加されています。v1.0.0 ビルドでは登録されません）。

プライバシー

• 100％ローカルで動作します。MCP サーバーはお使いのマシン上で実行され、ネットワーク通信は一切行いません。
• テレメトリー、分析、外部への自動通信はありません。
• 無料ツールはキー不要で、いつまでも完全にオフラインで動作します。
• Pro ツール（近日公開予定）はオフラインの Ed25519 ライセンスチェックで制限されます。使用時にネットワーク通信が発生することはありません。

インストール

# npx — no install required
npx -y @truepathpdf/mcp-server

# or install globally
npm install -g @truepathpdf/mcp-server
truepath-pdf-mcp

Node.js 22.13 以降が必要です（PDF.js 6 で必要です）。

Claude Desktop との接続

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "truepath-pdf": {
      "command": "npx",
      "args": ["-y", "@truepathpdf/mcp-server"]
    }
  }
}

Claude Desktop を再起動すると、ツールトレイに truepath-pdf ツールが表示されます。

ツール（v0.2）

get_info

ページ数、1 ページ目のサイズ（allSameSize フラグ付き）、暗号化の状態、埋め込み PDF メタデータ（タイトル、作成者、日付、プロデューサー、形式のバージョン）を取得します。

{ "path": "/Users/you/Documents/report.pdf" }

extract_text

プレーンテキストを抽出します。ページ範囲は任意で 1 始まりです（"3"、"1-5"、"1,3,5-7"）。出力はページごとにまとめられ、モデルが該当ページを引用できるように ===== Page N ===== マーカーが付与されます。

{ "path": "/Users/you/Documents/report.pdf", "pages": "1-3" }

search

ドキュメント全体を対象に部分一致検索を行います。各検索結果のページ、ページ内のオフセット、前後のテキストを含むスニペットを返します。より詳細な extract_text の前に、grep のように対象を探す用途に適しています。

{ "path": "/Users/you/Documents/report.pdf", "query": "revenue", "contextChars": 80 }

split

1 つの PDF をページ範囲に基づいて N 個に分割します。各範囲が 1 つの出力ファイルになります。

{ "path": "/in.pdf", "ranges": ["1-3", "4-7", "8"], "outputDir": "/out" }

merge

2 つ以上の PDF を、指定した順序で 1 つに結合します。

{ "paths": ["/a.pdf", "/b.pdf", "/c.pdf"], "outputPath": "/out/merged.pdf" }

pages

ページの削除、回転、並べ替えを 1 回の処理で行います。delete が最初に適用されます（rotate のページ番号は元の PDF を参照します）。reorder は残ったページに適用されます。

{
  "path": "/in.pdf",
  "outputPath": "/out/edited.pdf",
  "delete": "2,5",
  "rotate": [{ "page": 1, "degrees": 90 }],
  "reorder": [3, 1, 2]
}

to_images

PDF のページを、指定した DPI で PNG または JPG にラスタライズします。一般的な DPI：96（画面表示）、150（印刷プレビュー）、300（印刷）。

{ "path": "/in.pdf", "outputDir": "/out", "pages": "1-5", "dpi": 150, "format": "png" }

extract_images

PDF に埋め込まれた画像を取り出し、それぞれ PNG として書き出します。非対応のピクセル形式（CMYK、パレット形式など）のためにスキップされた画像があれば報告します。

{ "path": "/in.pdf", "outputDir": "/out" }

open_in_truepath

truepath://open?path=… を介して、ローカル PDF を TruePath PDF Mac アプリに渡します。実行後の完了を待たずに処理します。macOS がアプリを起動（またはアプリに処理を引き継ぎ）、URL ハンドラーが PDF を開きます。MCP で読み取り・分析した後、注釈の追加、署名、墨消しなどを行うため、ユーザーが GUI で PDF を開くときに使用します。

{ "path": "/Users/you/Documents/report.pdf" }

ブランドを変更したエンジンビルドでは任意の scheme パラメーターを指定できます（デフォルトは truepath。Yochen のコアビルドでは yochenpdf を使用します）。

アプリがインストールされていない場合（truepath:// ハンドラーが登録されていない場合。アプリが存在しないか、v1.0.1 より古い場合）、ツールはエラーを返しません。handedOff: false と、TruePath PDF のダウンロード先を案内する 1 行のメッセージを返すため、インストールして再試行できます（デフォルトの truepath スキームの場合のみ。カスタムの scheme では通常の失敗を返します）。

ロードマップ

Pro ティア（v0.4、Ed25519 ライセンスキー、オフライン検証）

• redact — PDFium による、テキストを保持した墨消し（Mac アプリと同じエンジンを使用します。文字列を覆い隠すだけでなく、ファイルから削除します）
• fill_form — AcroForm フィールドに入力し、値を保持した状態で保存します
• flatten — 入力済みフォームや注釈をページストリームに埋め込みます
• sign — 署名を見える位置に配置し、署名済み PDF を書き出します
• compress — 画像やストリームを再圧縮してファイルサイズを縮小します
• annotate — ハイライト、下線、付箋をプログラムで追加します
• autocrop — コンテンツの境界を検出して余白をトリミングします
• batch — glob に一致するファイルに任意のツールを適用します
• ocr — Apple Vision による OCR（Mac 専用、デバイス上で処理、CJK に強い）

買い切りの Pro キーは、提供開始時に Lemon Squeezy から購入できるようになります（予定価格：29 USD、12 か月間のアップデートを含みます）。TruePath PDF Mac アプリの所有者は、アプリ内ボタンから App Store の領収書を引き換えて、Pro MCP キーを入手できるようになります。

ライセンス

MCP シェルは MIT ライセンスです。推移的依存関係：

• @modelcontextprotocol/sdk — MIT
• pdfjs-dist — Apache 2.0
• pdf-lib — MIT
• @napi-rs/canvas — MIT
• zod — MIT

Pro ティアには、ビルド済みの PDFium ライブラリも追加で同梱されます（BSD/Apache ライセンス。Chrome と同じライブラリです）。

お問い合わせ

• Issues: https://github.com/JoyTruepath/truepath-pdf-mcp/issues
• メール：[email protected]
• Joy Truepath Pte. Ltd.、シンガポール（UEN 202205336E）