PDF.co

PDF.co MCP

PDF.co MCP サーバーは、Model Context Protocol（MCP）を通じて PDF.co API の機能を提供し、AI アシスタントがさまざまな PDF 処理タスクを簡単に実行できるようにします。

🚀 主な機能

📄 PDF 変換ツール

• PDF → 各種形式：PDF を JSON、CSV、テキスト、Excel（XLS/XLSX）、XML、HTML、画像（JPG/PNG/WebP/TIFF）に変換します
• 各種形式 → PDF：ドキュメント（DOC/DOCX/RTF/TXT）、スプレッドシート（CSV/XLS/XLSX）、画像、ウェブページ、HTML、メール（MSG/EML）を PDF に変換します
• Excel 変換：Excel ファイルを PDF に変換します

🛠️ PDF の編集と変更

• PDF の結合：複数の PDF ファイルを 1 つにまとめます
• PDF の分割：特定のページまたはページ範囲で PDF を分割します
• 注釈と画像の追加：PDF にテキスト、リンク、画像、図形を追加します
• フォーム操作：PDF フォームのフィールド情報を読み取り、フォームに入力し、新しいフォーム要素を作成します

🔍 PDF の検索と分析

• テキスト検索：PDF 内のテキストを検索します（正規表現をサポート）
• 表の検出：PDF 内の表の位置と座標を検出します
• AI 請求書パーサー：AI を使用して請求書データを抽出します
• PDF 情報：メタデータ、ページ数、セキュリティ情報などの詳細情報を取得します

🔒 セキュリティとアクセシビリティ

• パスワード保護：PDF のパスワード保護を追加または解除します
• 検索可能性：OCR によって PDF を検索可能にするか、テキストレイヤーを削除します
• 添付ファイルの抽出：PDF から添付ファイルを抽出します

💼 ファイル管理

• ファイルのアップロード：ローカルファイルを PDF.co サーバーにアップロードします
• ジョブステータスの追跡：非同期操作の進行状況と結果を監視します

⚙️ 設定

🔑 API キーの取得

1. PDF.co website でサインアップします
2. ダッシュボードから API キーを取得します

📦 UV のインストール

この MCP サーバーを使用するには、高速な Python パッケージングツールである UV をインストールする必要があります。

macOS と Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

その他のインストール方法

• Homebrew：brew install uv
• pipx を使った PyPI：pipx install uv
• pip を使った PyPI：pip install uv

その他のインストール方法と詳細については、UV installation guide をご覧ください。

MCP サーバーのセットアップ

Cursor IDE の設定

.cursor/mcp.json ファイルに以下を追加します。

{
  "mcpServers": {
    "pdfco": {
      "command": "uvx",
      "args": ["pdfco-mcp"],
      "env": {
        "X_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Desktop の設定

claude_desktop_config.json ファイルに以下を追加します。

{
  "mcpServers": {
    "pdfco": {
      "command": "uvx",
      "args": ["pdfco-mcp"],
      "env": {
        "X_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

🔧 利用可能なツール

PDF 変換ツール

• pdf_to_json：PDF とスキャンした画像を、テキスト、フォント、画像、ベクター、書式を保持した JSON 表現に変換します
• pdf_to_csv：PDF とスキャンした画像を、レイアウト、列、行、表を含む CSV 表現に変換します
• pdf_to_text：PDF とスキャンした画像を、レイアウトを保持したテキストに変換します
• pdf_to_xls：PDF とスキャンした画像を XLS（Excel 97-2003）形式に変換します
• pdf_to_xlsx：PDF とスキャンした画像を XLSX（Excel 2007 以降）形式に変換します
• pdf_to_xml：PDF とスキャンした画像を XML 形式に変換します
• pdf_to_html：PDF とスキャンした画像を HTML 形式に変換します
• pdf_to_image：PDF とスキャンした画像をさまざまな画像形式（JPG、PNG、WebP、TIFF）に変換します

ドキュメントから PDF への変換ツール

• document_to_pdf：さまざまな種類のドキュメント（DOC、DOCX、RTF、TXT、XLS、XLSX、CSV、HTML、JPG、PNG、TIFF、WEBP）を PDF に変換します
• csv_to_pdf：CSV またはスプレッドシートファイル（XLS、XLSX）を PDF に変換します
• image_to_pdf：さまざまな画像形式（JPG、PNG、TIFF）を PDF に変換します
• webpage_to_pdf：外部ウェブページの URL を PDF に変換します
• html_to_pdf：HTML を PDF に変換します
• email_to_pdf：メールを PDF に変換します

Excel 変換ツール

廃止のお知らせ — 2027年1月5日

以下の Excel 変換ツールは、基盤となる PDF.co API エンドポイントの提供終了に伴い、2027年1月5日に廃止される予定です：excel_to_csv、excel_to_json、excel_to_html、excel_to_txt、excel_to_xml。これらのツールは廃止日まで利用できます。2027年1月5日以降、基盤となる API エンドポイントへのリクエストはサポートされなくなります。excel_to_pdf は影響を受けません。

• excel_to_csv：Excel（XLS、XLSX）を CSV に変換（2027年1月5日に廃止）
• excel_to_json：Excel（XLS、XLSX）を JSON に変換（2027年1月5日に廃止）
• excel_to_html：Excel（XLS、XLSX）を HTML に変換（2027年1月5日に廃止）
• excel_to_txt：Excel（XLS、XLSX）を TXT に変換（2027年1月5日に廃止）
• excel_to_xml：Excel（XLS、XLSX）を XML に変換（2027年1月5日に廃止）
• excel_to_pdf：Excel（XLS、XLSX）を PDF に変換

PDF 編集ツール

• pdf_add_annotations_images_fields：テキスト、画像、フォーム、その他の PDF、フォームへの入力、外部サイトや外部 PDF ファイルへのリンクを追加します。PDF ファイルやスキャンした PDF ファイルを更新または変更できます
• pdf_merge：2 つ以上の PDF、DOC、XLS、画像、さらにはドキュメントや画像を含む ZIP ファイルから PDF を結合し、新しい PDF を作成します
• pdf_split：ページインデックスまたはページ範囲を指定して、PDF を複数の PDF ファイルに分割します

PDF フォームツール

• read_pdf_forms_info：入力 PDF ファイルから入力可能な PDF フィールドの情報を抽出します
• fill_pdf_forms：PDF ドキュメント内の既存のフォームフィールドに入力します
• create_fillable_forms：新しい入力可能なフォーム要素を PDF ドキュメントに作成します

PDF 検索ツール

• find_text：PDF 内のテキストを検索し、座標を取得します。正規表現に対応しています
• find_table：PDF 内の表を検索し、座標を取得します

PDF 分析ツール

• ai_invoice_parser：AI 請求書パーサー：AI を使用して請求書からデータを抽出します
• extract_attachments：ソース PDF ファイルから添付ファイルを抽出します
• pdf_info_reader：PDF ドキュメントに関する詳細情報（ページ数、メタデータ、セキュリティ、フォームフィールドなど）を取得します

PDF セキュリティツール

• pdf_add_password：PDF ファイルにパスワード保護を追加します
• pdf_remove_password：PDF ファイルのパスワード保護を解除します

PDF 検索可能化ツール

• pdf_make_searchable：スキャンした PDF ドキュメントや画像ファイルを、テキスト検索可能な PDF に変換します。OCR を実行し、テキスト検索に使用できる不可視のテキストレイヤーを追加します
• pdf_make_unsearchable：既存の PDF ドキュメントからテキストレイヤーを削除し、検索できない状態にします

ファイル管理ツール

• upload_file：PDF.co API にファイルをアップロードします
• get_job_check：ジョブのステータスと結果を確認します。ステータスは working、success、failed、aborted、unknown のいずれかです
• wait_job_completion：ジョブが完了するまで待機します

📖 使用例

PDF をテキストに変換

Convert this PDF file to text: https://example.com/document.pdf

複数の画像を 1 つの PDF に結合

Create a PDF from these images: image1.jpg, image2.png, image3.jpg

PDF 内の特定のテキストを検索

Find the word "contract" in this PDF document

PDF フォームフィールドに入力

Fill the name field in this PDF form with "John Doe"

Web ページを PDF に変換

Convert https://example.com webpage to PDF

請求書データを抽出

Extract invoice information from this PDF using AI

パスワード保護を追加

Add password protection to this PDF file

📞 サポートとお問い合わせ

• PDF.co：https://pdf.co
• PDF.co API ドキュメント：https://developer.pdf.co
• 問題の報告：GitHub Issues から問題を報告してください

📄 ライセンス

このプロジェクトは MIT ライセンスの下で配布されています。

---

注：このツールを使用するには、有効な PDF.co API キーが必要です。PDF.co で無料アカウントを作成し、API キーを取得してください。