Pdfco MCP

🚀 PDF.co MCP

PDF.co MCP Serverは、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ファイルをCSV、JSON、HTML、TXT、XML、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ウェブサイト でサインアップします。
2. ダッシュボードからAPIキーを取得します。

📦 UVのインストール

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

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
• PyPI with pipx：pipx install uv
• PyPI with pip：pip install uv

詳細なインストールオプションと詳細については、UVインストールガイド を参照してください。

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変換ツール

• excel_to_csv：Excel（XLS、XLSX）をCSVに変換します。
• excel_to_json：Excel（XLS、XLSX）をJSONに変換します。
• excel_to_html：Excel（XLS、XLSX）をHTMLに変換します。
• excel_to_txt：Excel（XLS、XLSX）をTXTに変換します。
• excel_to_xml：Excel（XLS、XLSX）をXMLに変換します。
• 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_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を使用して請求書からデータを抽出します。
• 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：ジョブのステータスと結果を確認します。ステータスは、作業中、成功、失敗、中止、または不明です。
• wait_job_completion：ジョブの完了を待ちます。

💻 使用例

PDFをテキストに変換

このPDFファイルをテキストに変換してください：https://example.com/document.pdf

複数の画像をPDFにマージ

これらの画像からPDFを作成してください：image1.jpg, image2.png, image3.jpg

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

このPDFドキュメント内で「contract」という単語を検索してください。

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

このPDFフォームの名前フィールドに「John Doe」を入力してください。

ウェブページをPDFに変換

https://example.comのウェブページをPDFに変換してください。

請求書データを抽出

このPDFからAIを使用して請求書情報を抽出してください。

パスワード保護を追加

このPDFファイルにパスワード保護を追加してください。

📖 サポートと問い合わせ

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

📄 ライセンス

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

⚠️ 重要提示

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