PDF Forms

🚀 MCP PDF フォーム

このツールキットは、MCP と PyMuPDF を使用して構築された PDF フォーム操作ツールです。複数のディレクトリから PDF ファイルを検索し、フォームフィールドの情報を抽出し、可視化することができます。

🚀 クイックスタート

このツールキットを使用することで、PDF フォームの操作を簡単に行うことができます。以下の手順に従って、素早く始めましょう。

✨ 主な機能

• 複数のディレクトリ内で PDF ファイルを検索します。
• PDF ファイルからフォームフィールドの情報を抽出します。
• PDF 文書内のフォームフィールドを可視化します。

📦 インストール

# PyPI からパッケージをインストールする
pip install mcp_pdf_forms

# またはソースコードからインストールする
git clone https://github.com/Wildebeest/mcp_pdf_forms.git
cd mcp_pdf_forms
pip install -e .

💻 使用例

コマンドラインツール

インストールが完了したら、mcp-pdf-forms コマンドを使用してサーバーを起動できます。

# 1 つまたは複数のディレクトリを指定して PDF ファイルをスキャンする
mcp-pdf-forms examples

また、Claude Code に MCP として追加することもできます。

claude mcp add pdf-forms mcp-pdf-forms .

各ツールの使用方法

インストールが完了したら、このパッケージを使って MCP インターフェース経由で操作することができます。

基本的な使用法

PDF 発見ツール

PDF 発見ツールは、指定されたディレクトリ内の PDF ファイルを検索します。

• 入力：検索対象のディレクトリのパス
• 出力：指定されたディレクトリ内で見つかったすべての PDF ファイルのリスト
• 使用シーン：プロジェクトや指定されたフォルダ内のすべての PDF ファイルを素早く見つける

フォームフィールド抽出ツール

フォームフィールド抽出ツールは、PDF 文書からすべてのフォームフィールドの情報を抽出します。

• 入力：PDF ファイルのパス
• 出力：各フォームフィールドの詳細情報（フィールド名、タイプ、位置、その他の属性を含む）
• 使用シーン：フォームの構造を分析し、入力可能なフィールドを把握する

フィールドハイライト可視化ツール

フィールドハイライトツールは、すべてのフォームフィールドが強調表示された新しい PDF ファイルを生成します。

• 入力：PDF ファイルのパス
• 出力：フォームフィールドがハイライトされた修正後の PDF ファイル
• 使用シーン：文書内のフォームフィールドのレイアウトと位置を直感的に確認する

📚 ドキュメント

使用しているライブラリ

• MCP - マシン対話プロトコルフレームワーク
• PyMuPDF - 高性能 PDF ライブラリ MuPDF の Python バインディング

📄 ライセンス

MIT