📄 MCP PDF サーバー

FastMCPをベースにした PDF ファイル読み取りサーバー。

PDF テキスト抽出、OCR 認識、MCP プロトコル経由の画像抽出をサポートし、テストを簡単に行うための Web デバッガーが組み込まれています。

🚀 機能

PDFテキストを読む
PDF から通常のテキストを抽出します (ページごとに)。
OCRによる読み取り
OCR を使用して、スキャンされた PDF または画像ベースの PDF からテキストを認識します。
PDF画像を読む
指定された PDF ページからすべての画像を抽出します (Base64 エンコードされた出力)。

📂 プロジェクト構造

mcp-pdf-server/ ├── pdf_resources/ # Directory for uploaded and processed PDF files ├── txt_server.py # Main server entry point └── README.md # Project documentation

⚙️ インストール

推奨される Python バージョン: 3.9 以上

pip install pymupdf mcp

注意: OCR 機能を使用するには、OCR サポートまたは外部 OCR ライブラリを備えた MuPDF ビルドが必要になる場合があります。

🔦 サーバーを起動する

次のコマンドを実行します。

python txt_server.py

次のようなログが表示されます。

Serving on http://127.0.0.1:6231

🌐 Webデバッグインターフェース

ブラウザを開いて次のサイトにアクセスしてください:

http://127.0.0.1:6231

左パネルからツールを選択します
右側のパネルにパラメータを入力します
「実行」をクリックしてツールをテストします

コーディングは不要で、Web UI 経由で簡単にデバッグおよびテストできます。

🛠️ APIツールリスト

道具	説明	入力パラメータ	返品
`read_pdf_text`	PDFページから通常のテキストを抽出します	`file_path` 、 `start_page` 、 `end_page`	ページテキストのリスト
`read_by_ocr`	OCRでテキストを認識する	`file_path` 、 `start_page` 、 `end_page` 、 `language` 、 `dpi`	OCRで抽出したテキスト
`read_pdf_images`	PDFページから画像を抽出します	`file_path` 、 `page_number`	画像リスト（Base64エンコード）