PDF4me

PDF4me MCP Server

PDF4me MCP Server は、Model Context Protocol（MCP）を通じてPDF4me APIの機能を提供し、AI アシスタントがPDF、ドキュメント、画像、バーコードに関する幅広い処理を簡単に実行できるようにします。

---

🚀 主な機能

📄 PDF 変換

• PDF → Office：PDFをWord（DOCX）、Excel（XLSX）、PowerPoint（PPTX）に変換します
• PDF → その他の形式：PDFをPDF/A、検索可能なOCR PDF、HTML、Markdownに変換します
• Office → PDF：DOCX、PPTX、XLSX、CSV、HTML、Markdown、Visio、画像をPDFに変換します
• Word → PDFフォーム：Word文書を入力可能なPDFフォームに変換します
• JSON → Excel：JSONデータファイルをExcelワークブックに変換します

🛠️ PDF の編集と変更

• スタンプと透かし：PDFにテキストまたは画像のスタンプや透かしを追加します
• ヘッダーとフッター：HTMLベースのヘッダーとフッターを挿入します
• 注釈：ページ番号、余白、ハイパーリンクの注釈を追加します
• 添付ファイル：任意のファイルをPDF内に添付ファイルとして埋め込みます
• 署名：PDFページに署名画像を適用します
• 検索と置換：テキストを検索して置換するか、テキストを画像に置き換えます

📐 PDF の整理

• 結合：複数のPDFを結合するか、2つのPDFを重ね合わせます
• 分割：ページ、ページ範囲、バーコード、Swiss QRコード、一致するテキストで分割します
• 削除／抽出：特定のページを削除または抽出し、空白ページを削除します
• 回転：PDFのすべてのページまたは選択したページを回転します

🔍 PDF の抽出と分析

• フォームデータ：入力可能なPDFフォームフィールドから値を抽出します
• 表：座標情報付きで表を検出して抽出します
• テキスト：正規表現でテキストを抽出し、テキストを検索して置換します
• 添付ファイル：PDFに埋め込まれたファイルの添付ファイルを取り出します
• リソース：PDFコンテンツからテキストと画像を抽出します
• 分類：文書の種類、カテゴリ、信頼度に基づいてPDFを分類します

🤖 AI によるドキュメント処理

• 請求書、注文書、領収書：AIを使用して構造化データを抽出します
• 銀行取引明細書と小切手：金融文書を自動的に解析します
• 契約書と住宅ローン関連書類：法律文書から主要な項目を抽出します
• 税務書類と給与明細：税務フォームと給与関連文書を解析します
• IDとカード：健康保険証、クレジットカード、婚姻証明書、配送ラベルを処理します
• 汎用抽出：あらゆる種類の文書からAIで汎用的なデータを抽出します

🏷️ バーコードとQRコード

• 作成：バーコードとQRコード（PNG）を生成します
• PDFに追加：バーコードまたはQRコードをPDFページにスタンプとして追加します
• PDF／画像から読み取り：バーコードとQRコードを検出してデコードします
• Swiss QR Bill：Swiss QR Billの決済セクションを作成して読み取り、Swiss QRでPDFを分割します

🖼️ 画像処理

• 形式変換：BMP、GIF、JPG、PNG、TIFF間で変換します
• 編集：画像のサイズ変更、回転、反転、トリミングを行います
• 透かし：画像に画像またはテキストの透かしを追加します
• OCR：OCRを使用して画像からテキストを抽出します
• メタデータ：EXIFメタデータを読み取るか削除します
• 圧縮：品質レベルを設定して画像を圧縮します

📝 Word とドキュメントのツール

• 変更履歴：Word文書の変更履歴を有効化、無効化、または抽出します
• テキストを画像に置換：Word文書内のテキストのプレースホルダーを画像に置き換えます
• テキスト抽出：ヘッダー／フッターとコメントの制御機能を使って、Word文書からテキストを取り出します

📦 ドキュメント生成

• 単一ドキュメント：テンプレートとデータ（JSON、XML、またはプレーンテキスト）から1つのドキュメントを生成します
• 一括ドキュメント：1つのテンプレートとデータセットから複数のドキュメントを生成します

🔒 セキュリティ

• PDFの保護：権限を設定可能なパスワード保護を適用します
• PDFのロック解除：PDFのパスワード保護を解除します
• ZUGFeRD請求書：規格に準拠したZUGFeRD電子請求書（XMLまたはPDF+XML）を作成します

⚙️ ユーティリティ

• ファイルのアップロード：ローカルファイルをPDF4meのクラウドストレージにアップロードします
• PDFメタデータ：完全なメタデータ（タイトル、作成者、ページ数、セキュリティ情報、日付）を読み取ります
• 画像メタデータ：画像のプロパティとEXIFフィールドを読み取ります
• PDFの修復：破損または不正な形式のPDFを修復します
• PDFの最適化：PDFの圧縮、リニアライズ（Web向け最適化）、またはフラット化を行います

---

⚙️ 設定

🔑 APIキーの取得

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

📦 UVのインストール

このMCPサーバーを実行するには、UV（高速なPythonパッケージングツール）が必要です。

macOS / Linux

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

Windows（PowerShell）

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

その他の方法

# Homebrew (macOS)
brew install uv

# pipx
pipx install uv

# pip
pip install uv

詳しくは、UVのインストールガイドをご覧ください。

---

🔧 MCPクライアントの設定

Cursor

Cursorの「Settings」→「MCP」を開くか、~/.cursor/mcp.json（macOS/Linux）または%USERPROFILE%\.cursor\mcp.json（Windows）を編集します。

{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "PDF4ME_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop

Claude Desktopの設定ファイルを開きます。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "PDF4ME_API_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code

~/.config/Code/User/mcp.json（macOS/Linux）または%APPDATA%\Code\User\mcp.json（Windows）を開きます。

{
  "servers": {
    "pdf4me-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "PDF4ME_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.jsonを編集します。

{
  "mcpServers": {
    "pdf4me-mcp": {
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "PDF4ME_API_KEY": "your-api-key-here"
      }
    }
  }
}

Continue（VS Code / JetBrains拡張機能）

~/.continue/config.jsonに追加します。

{
  "mcpServers": [
    {
      "name": "pdf4me-mcp",
      "command": "uvx",
      "args": ["pdf4me-mcp"],
      "env": {
        "PDF4ME_API_KEY": "your-api-key-here"
      }
    }
  ]
}

---

🪟 Windowsに関する注意

Windowsでは、uvxがPATHにない場合、フルパスを指定して呼び出す必要があります。"command": "uvx"をフルパスに置き換えます。例：

"command": "C:\\Users\\<YourUser>\\.local\\bin\\uvx"

---

🛠️ 利用可能なツール

🏷️ バーコードツール

ツール	説明
add_barcode_to_pdf	配置とサイズを設定して、PDFページにバーコードまたはQRコードを描画します
create_barcode	PNG画像としてバーコードまたはQRコードを生成します（Code128、QRなどに対応）
read_barcodes	バーコードの種類とページで絞り込みながら、ローカルPDFからバーコード／QRコードのデータを読み取り、デコードします
read_barcodes_from_image	ローカル画像ファイルからバーコードとQRコードを検出し、デコードします
create_swiss_qr_bill	スイスQRビルの支払いセクション（IBAN、債権者情報、通貨、参照情報）をPDFに追加します
read_swiss_qr_bill	ローカルPDFからスイスQRビルの支払いデータを解析、抽出します
split_pdf_by_barcode	特定のバーコード値または種類を含むページでPDFを分割します
split_pdf_by_swiss_qr	スイスQRコードの位置に基づいてPDFを分割し、個別のPDFファイルまたはZIPアーカイブを作成します

---

🔄 変換ツール

ツール	説明
convert_to_pdf	ドキュメント（DOCX、PPTX、XLSX、画像、テキスト形式）を PDF に変換します
convert_html_to_pdf	レイアウト、余白、印刷オプションを指定して、ローカルの HTML ファイルを PDF に変換します
convert_url_to_pdf	認証、レイアウト、余白の設定を指定して、Web ページの URL を PDF に変換します
convert_md_to_pdf	ローカルの Markdown ファイルを PDF に変換します
convert_visio_to_pdf	Visio ファイル（.vsdx/.vsd/.vsdm）を PDF に変換します
convert_word_to_pdf_form	Word ドキュメント（DOCX）を入力可能な PDF フォームに変換します
convert_pdf_to_word	品質設定、言語、任意の OCR を指定して、PDF を DOCX に変換します
convert_pdf_to_excel	品質、シートの結合、言語、任意の OCR を指定して、PDF を XLSX に変換します
convert_pdf_to_powerpoint	品質、言語、任意の OCR を指定して、PDF を PPTX に変換します
convert_pdf_to_pdfa	アップグレード／ダウングレード制御を使用して、PDF を PDF/A（PdfA1a から PdfA3u）に変換します
convert_ocr_pdf	OCR を実行してテキストレイヤーを埋め込み、スキャンした PDF を検索可能にします
convert_json_to_excel	ワークシート名とタイトルのオプションを指定して、ローカルの JSON ファイルを Excel ブック（XLSX）に変換します
convert_image_format	BMP、GIF、JPG、PNG、TIFF 形式間で画像を変換します
flatten_pdf	PDF をフラット化します（フォームフィールドと注釈をページコンテンツに統合します）
linearize_pdf	設定可能な最適化プリセットを使用して、ブラウザーでの読み込みを高速化するために PDF をリニアライズ（Web 用に最適化）します

---

✏️ PDF 編集ツール

ツール	説明
add_attachment_to_pdf	1 つ以上のファイルを PDF 内に添付ファイルとして埋め込みます
add_html_header_footer_to_pdf	HTML 形式のヘッダー、フッター、またはその両方を PDF のページに追加します
add_margin_to_pdf	PDF のすべてのページに余白（ミリメートル単位）を追加します
add_page_number_to_pdf	配置、書式、フォントスタイルを設定してページ番号を挿入します
add_image_stamp_to_pdf	配置、不透明度、サイズを指定して、PDF のページに画像スタンプまたは透かしを配置します
add_text_stamp_to_pdf	フォント、不透明度、回転、配置のオプションを指定して、PDF のページにテキストスタンプまたは透かしを配置します
sign_pdf	レイアウトと余白のオプションを指定して、PDF に署名画像を適用します
find_and_replace_text	PDF のページ全体でテキストを検索して置換します
replace_text_with_image	設定可能な寸法の画像を使用して、PDF 内のテキストを置換します
update_hyperlink_annotation	検索条件に基づいて、PDF 内のハイパーリンク注釈を更新または置換します
repair_pdf	破損または不正な形式の PDF ファイルを修復します

---

📤 抽出ツール

ツール	説明
extract_pages_from_pdf	PDF から特定のページを抽出し、新しい PDF ファイルに保存します
extract_form_data_from_pdf	PDF からすべてのフォームフィールド名と現在の値を抽出します
extract_attachment_from_pdf	PDF に埋め込まれたファイル添付を抽出してディスクに保存します
extract_resources	PDF に埋め込まれたテキストコンテンツと画像を抽出します
extract_table_from_pdf	PDF 内の表を検出して抽出し、結果を JSON と CSV として保存します
extract_text_by_expression	正規表現パターンを使用して PDF からテキストを抽出します
extract_text_from_word	ヘッダー、フッター、コメントを削除するオプションを指定して、Word ドキュメントからテキストを抽出します
extract_text_from_image	OCR を使用して画像からテキストを抽出します
classify_document	信頼度スコアとともに、PDF をドキュメントの種類とカテゴリで分類します
parse_document	定義済みの PDF4me 解析テンプレートを使用して、PDF から構造化データを抽出します

---

📋 フォームツール

ツール	説明
add_form_fields_to_pdf	指定した座標に新しい TextBox または CheckBox フォームフィールドを PDF に追加します
fill_pdf_form	キーと値のデータマップを使用して、PDF 内の既存のフォームフィールドに入力します

---

📝 ドキュメント生成ツール

ツール	説明
generate_document_single	テンプレート（DOCX/HTML/PDF）とデータペイロード（JSON/XML/テキスト）から1つのドキュメントを生成します
generate_documents_multiple	1つのテンプレートと複数レコードのデータセットから、複数のドキュメントを一括生成します
enable_tracking_changes_in_word	Word ドキュメントで変更履歴モードを有効にします
disable_tracking_changes_in_word	Word ドキュメントで変更履歴モードを無効にします
get_tracking_changes_in_word	Word ドキュメントの変更履歴データをすべて構造化 JSON として抽出します
replace_text_with_image_in_word	Word ドキュメント内のテキストプレースホルダーを画像に置き換えます

---

🖼️ 画像ツール

ツール	説明
add_image_watermark_to_image	不透明度と位置を調整して、ある画像に別の画像の透かしを重ねます
add_text_watermark_to_image	フォント、色、不透明度、回転を指定して、画像にテキストの透かしを追加します
compress_image	圧縮レベルを指定して、JPG、PNG、WebP 画像を圧縮します
convert_image_format	BMP、GIF、JPG、PNG、TIFF 形式の間で画像を変換します
create_images_from_pdf	ページの選択と幅の指定を行い、PDF ページを画像ファイル（JPEG、PNG、TIFF）に変換します
crop_image	境界または指定した矩形領域で画像をトリミングします
flip_image	画像を水平方向または垂直方向に反転します
get_image_metadata	JPG または PNG ファイルから画像のプロパティと EXIF メタデータを抽出します
extract_text_from_image	画像に OCR を実行して、テキスト内容を抽出します
resize_image	アスペクト比を調整しながら、割合または指定した寸法で画像のサイズを変更します
rotate_image	背景色とサイズ変更オプションを指定して、画像を指定した角度で回転します
rotate_image_by_exif_data	EXIF メタデータに基づいて、画像を正しい向きに自動回転します
remove_exif_tags_from_image	JPG または PNG 画像からすべての EXIF メタデータを削除します

---

🔗 結合・分割ツール

ツール	説明
merge_multiple_pdfs	2つ以上の PDF ファイルを1つの PDF に結合します
merge_pdf_overlay	ある PDF を別の PDF の上に重ねます（例：レターヘッドのスタンプ）
split_pdf	ページ番号、繰り返し間隔、シーケンス、またはページ範囲で PDF を分割します
split_pdf_by_barcode	指定したバーコードを含むページで PDF を分割します
split_pdf_by_swiss_qr	Swiss QR コードの位置で PDF を分割します
split_pdf_by_text	特定のテキスト文字列を含むページで PDF を分割します

---

⚡ 最適化ツール

ツール	説明
compress_pdf	Web、印刷、画面向けの最適化プロファイルを使用して PDF を圧縮します
delete_blank_pages_from_pdf	空白ページ（テキストなし、画像なし、またはその両方）を PDF から削除します
linearize_pdf	Web ブラウザーでの高速な段階的読み込みに対応するよう PDF をリニアライズします

---

📂 整理ツール

ツール	説明
delete_pdf_pages	ページ番号または範囲を指定して、PDF から特定のページを削除します
extract_pages_from_pdf	PDF から選択したページを新しいファイルに抽出します
rotate_pdf	PDF のすべてのページを回転します（時計回り、反時計回り、上下逆）
rotate_pdf_page	選択したページを個別に回転します

---

📊 PDF 情報ツール

ツール	説明
get_pdf_metadata	PDF の全メタデータ（タイトル、作成者、ページ数、セキュリティ情報、日付）を読み取ります
get_image_metadata	JPG または PNG の画像プロパティと利用可能な EXIF フィールドを読み取ります
repair_pdf	破損または形式に問題のある PDF の修復を試みます

---

🔒 セキュリティツール

ツール	説明
protect_pdf	印刷、コピー、編集などの権限を設定して、PDF をパスワードで保護します
unlock_pdf	現在のパスワードを使用して、PDF のパスワード保護を解除します

---

🤖 AI 文書処理ツール

ツール	説明
process_invoice	AI を使用して、PDF または画像から構造化された請求書データ（明細項目、合計、日付、ベンダー情報）を抽出します
process_bank_cheque	AI を使用して銀行小切手の画像を解析し、小切手の詳細情報を抽出します
process_contract	AI を使用して契約書から主要な条項と項目を抽出します
process_credit_card	AI を使用してカード画像からクレジットカード情報を抽出します
process_health_card	AI を使用して健康保険証の画像からデータを抽出します
process_marriage_certificate	AI を使用して婚姻証明書から項目を抽出します。オプションで真正性を検証できます
process_mortgage_document	AI を使用して住宅ローン関連書類から主要な財務情報と物件情報を抽出します
process_pay_stub	AI を使用して給与明細書から給与、控除、従業員の詳細情報を抽出します
process_bank_statement	AI を使用して銀行取引明細書を解析し、取引、残高、パターンを抽出します
process_order	AI を使用して注文書類から注文の詳細（品目、数量、価格、住所）を抽出します
process_receipt	AI を使用して領収書の画像または PDF から店舗情報、明細項目、合計を抽出します
process_shipping_label	AI を使用して配送ラベルから配送業者、追跡番号、住所データを抽出します
process_tax_document	AI を使用して税務書類から税務フォームの項目と計算値を抽出します
process_universal_document	AI を使用してあらゆる種類の文書から指定した項目を抽出します（項目リストを設定可能）

---

📜 ZUGFeRD／電子請求書ツール

ツール	説明
create_zugferd_invoice	XML、JSON、または CSV データから ZUGFeRD 準拠の電子請求書を作成します — PDF+XML または XML のみ

---

🗂️ ファイル管理ツール

ツール	説明
upload_file	ローカルファイルを PDF4me のクラウドストレージにアップロードし、以降の操作に使うファイル参照を受け取ります
get_document_from_pdf4me	PDF4me から文書を受け取るための Webhook コールバック URL を登録します

---

💡 使用例

PDF を Word に変換する：

Convert this PDF to a Word document: /path/to/document.pdf

複数の PDF を結合する：

Merge these PDFs into one: report.pdf, appendix.pdf, cover.pdf

AI を使用して請求書データを抽出する：

Extract all invoice details from this file: invoice.pdf

PDF にスイス QR 請求書を追加する：

Add a Swiss QR Bill to invoice.pdf with IBAN CH93-0076-2011-6238-5295-7, creditor name "Acme AG"

バーコードで PDF を分割する：

Split this PDF at every page containing a Code128 barcode: batch.pdf

テンプレートから文書を生成する：

Generate a contract PDF from contract_template.docx with this data: {"client": "ACME", "date": "2024-01-01"}

画像を圧縮する：

Compress this PNG image with maximum compression: photo.png

スキャンした PDF に OCR を実行する：

Make this scanned PDF searchable: scanned_report.pdf

---

🛠️ 手動実行（クライアントなし）

uvx pdf4me-mcp

または、ローカルにインストール済みの場合：

PDF4ME_API_KEY=your-api-key-here pdf4me-mcp

---

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

• PDF4me：pdf4me.com
• API ドキュメント：docs.pdf4me.com
• 問題の報告：GitHub Issues

---

📄 ライセンス

このプロジェクトは MIT License の下で配布されています。