Pdf2md

MCP-PDF2MD

English | 中文

MCP-PDF2MD サービス

MinerU API を活用した、MCP ベースの高性能な PDF から Markdown への変換サービスです。ローカルファイルと URL リンクのバッチ処理に対応し、構造化された出力を提供します。

主な機能

• フォーマット変換：PDF ファイルを構造化された Markdown 形式に変換します。
• 複数ソースへの対応：ローカルの PDF ファイルと URL リンクの両方を処理します。
• インテリジェントな処理：最適な処理方法を自動で選択します。
• バッチ処理：複数の PDF ファイルをまとめて変換し、大量のファイルを効率的に処理できます。
• MCP 連携：Claude Desktop などの LLM クライアントとシームレスに連携します。
• 構造の保持：見出し、段落、リストなど、元のドキュメントの構造を維持します。
• スマートレイアウト：人が読みやすい順序でテキストを出力し、1 段組み、複数段組み、複雑なレイアウトに対応します。
• 数式変換：ドキュメント内の数式を自動で認識し、LaTeX 形式に変換します。
• テーブル抽出：テーブルを自動で認識し、構造化形式に変換します。
• クリーンアップの最適化：ヘッダー、フッター、脚注、ページ番号などを削除し、意味の一貫性を保ちます。
• 高品質な抽出：PDF ドキュメントからテキスト、画像、レイアウト情報を高品質に抽出します。

システム要件

• ソフトウェア：Python 3.10 以降

クイックスタート

1. リポジトリをクローンし、ディレクトリに移動します：

   git clone https://github.com/FutureUnreal/mcp-pdf2md.git
   cd mcp-pdf2md
   

2. 仮想環境を作成し、依存関係をインストールします：

   Linux/macOS：

   uv venv
   source .venv/bin/activate
   uv pip install -e .
   

   Windows：

   uv venv
   .venv\Scripts\activate
   uv pip install -e .
   

3. 環境変数を設定します：

   プロジェクトのルートディレクトリに .env ファイルを作成し、次の環境変数を設定します：

   MINERU_API_BASE=https://mineru.net/api/v4/extract/task
   MINERU_BATCH_API=https://mineru.net/api/v4/extract/task/batch
   MINERU_BATCH_RESULTS_API=https://mineru.net/api/v4/extract-results/batch
   MINERU_API_KEY=your_api_key_here
   

4. サービスを起動します：

   uv run pdf2md
   

コマンドライン引数

サーバーは次のコマンドライン引数に対応しています：

Claude Desktop の設定

Claude Desktop に次の設定を追加します：

Windows：

{
    "mcpServers": {
        "pdf2md": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\path\\to\\mcp-pdf2md",
                "run",
                "pdf2md",
                "--output-dir",
                "C:\\path\\to\\output"
            ],
            "env": {
                "MINERU_API_KEY": "your_api_key_here"
            }
        }
    }
}

Linux/macOS：

{
    "mcpServers": {
        "pdf2md": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-pdf2md",
                "run",
                "pdf2md",
                "--output-dir",
                "/path/to/output"
            ],
            "env": {
                "MINERU_API_KEY": "your_api_key_here"
            }
        }
    }
}

API キーの設定に関する注意： API キーは次の 2 つの方法で設定できます：

1. プロジェクトディレクトリ内の .env ファイルに設定する（開発時に推奨）
2. 上記のように Claude Desktop の設定に記述する（通常の使用時に推奨）

両方の場所に API キーを設定した場合は、Claude Desktop の設定が優先されます。

MCP ツール

サーバーは次の MCP ツールを提供します：

• convert_pdf_url：PDF の URL を Markdown に変換します
• convert_pdf_file：ローカルの PDF ファイルを Markdown に変換します

MinerU API キーの取得

このプロジェクトは、PDF コンテンツの抽出に MinerU API を使用します。API キーを取得するには：

1. MinerU 公式サイトにアクセスして、アカウントを登録します
2. ログイン後、こちらのリンクから API テスト利用を申請します
3. 申請が承認されると、API 管理ページにアクセスできます
4. 表示される手順に従って API キーを生成します
5. 生成した API キーをコピーします
6. この文字列を MINERU_API_KEY の値として使用します

現在、MinerU API はテスト段階にあり、利用には MinerU チームの承認が必要です。承認には時間がかかる場合があるため、余裕をもって申請してください。

デモ

入力 PDF

出力 Markdown

ライセンス

MIT ライセンスの詳細については、LICENSE ファイルをご覧ください。

クレジット

このプロジェクトは MinerU の API を基にしています。