Pdf2md MCP

🚀 PDF2MD MCP Server

AIサンプリング機能を利用して、PDFファイルをMarkdown形式に変換するMCP（Model Context Protocol）サーバーです。

🚀 クイックスタート

このサーバーを使用することで、AIを用いたコンテンツ抽出機能を使ってPDFをMarkdownに変換できます。

✨ 主な機能

• AIを用いたコンテンツ抽出により、PDFファイルをMarkdownに変換します。
• ローカルファイルパスとURLの両方に対応しています。
• 途中から再開可能なインクリメンタル変換機能があります。
• 出力ディレクトリを設定可能です。
• 高性能なFastMCPを使用して構築されています。

📦 インストール

pip install pdf2md-mcp

💻 使用例

基本的な使用法

MCPサーバーとしての起動

pdf2md-mcp

サーバーが起動すると、PDFをMarkdownに変換するためのMCPツールが利用可能になります。

利用可能なツール

convert_pdf_to_markdown

AIサンプリングを使用して、PDFファイルをMarkdown形式に変換します。

パラメータ:

• file_path (文字列): PDFファイルのローカルファイルパスまたはURL
• output_dir (文字列、オプション): Markdownファイルの出力ディレクトリ。デフォルトは入力ファイルと同じディレクトリ（ローカルファイルの場合）または現在の作業ディレクトリ（URLの場合）

戻り値:

• output_file: 生成されたMarkdownファイルのパス
• summary: 変換タスクの概要
• pages_processed: 処理されたページ数

🔧 技術詳細

必要条件

• Python 3.10以上
• AIサンプリング機能を持つMCP互換クライアント
• URLベースのPDFファイルにアクセスするためのネットワーク接続

開発

セットアップ

git clone https://github.com/shuminghuang/pdf2md-mcp.git
cd pdf2md-mcp
pip install -e ".[dev]"

テストの実行

pytest

コードフォーマット

black .
isort .

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

貢献

貢献は大歓迎です！プルリクエストを自由に送信してください。