Pdf Tools MCP

🚀 PDF 工具 MCP

このツールは、モデルコンテキストプロトコル（MCP）に基づいて構築された包括的なPDF操作ツールです。PDFの表示、結合、メタデータ抽出など、様々な操作をサポートしています。

🚀 クイックスタート

PDF 工具 MCP を使用することで、ローカルおよびリモートのPDFに対する様々な操作を行うことができます。以下に、基本的な使い方を説明します。

✨ 主な機能

ローカルPDF操作

• 表示：PDFページを画像としてレンダリングします。
• 結合：複数のページを1つの長いページに結合します。
• メタデータ：ドキュメントのメタ情報を抽出します。
• テキスト：テキストブロックと詳細なテキスト情報を抽出します。
• フラグメント：PDFページから自由形式または全幅のフラグメントを作成します。
• 融合：複数のドキュメントのページを1つのドキュメントに結合します。

リモートPDF操作

• 表示：リモートのPDFページを画像としてレンダリングします。
• ダウンロード：URLからPDFを取得し、ローカルに保存します。

📦 インストール

# リポジトリをクローンする
git clone https://github.com/yourusername/pdf-tools-mcp.git
cd pdf-tools-mcp

# 依存関係をインストールする
uv pip install -e .

💻 使用例

基本的な使用法

MCPサーバーを起動するには、以下のコマンドを実行します。このサーバーは、MCPプロトコルを通じてPDF操作エンドポイントを提供します。

python -m src.main

🔧 技術詳細

• 開発環境：Python 3.12+ が必要です。
• ツール登録：MCPフレームワークを使用してツールを登録します。
• ファイル保存：PDFドキュメントはUUID4ファイル名で保存され、セキュリティが確保されます。

# 依存関係を更新する
uv pip install -e . --upgrade

# 変更をコミットする（約束事によるコミット形式を使用）
cz commit

📚 ドキュメント

依存関係

• MCPフレームワーク
• PyMuPDF
• 非同期操作にはaiohttp/aiofilesを使用します。
• ファイルタイプ検出にはpython-magic-binを使用します。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEを参照してください。