MCP Server PDF

PDFのリンクからPDFファイルをダウンロードするMCPサーバーです。

機能

• PDFのURLからファイルをダウンロード

• ダウンロード先ディレクトリを指定可能（未指定時はカレントディレクトリに保存）

• 自動的なファイル名生成（URLから抽出）

• カスタムファイル名の指定

• 既存ファイルの重複回避（自動リネーム）

• PDFからMarkdownへの変換（PyMuPDF4LLM使用）

• Content-Typeの検証

• セキュリティ対策（SSRF防止）

• エラーハンドリング

Related MCP server: Markdown Downloader

使用方法

MCPサーバーとして実行

uvコマンドで実行

python -m mcp_server_pdf

uvxコマンドで実行（推奨）

uvx --from . mcp-server-pdf

# または、GitHubから直接実行
uvx --from git+https://github.com/yourusername/mcp-server-pdf.git mcp-server-pdf

Claude for Desktopでの設定

uvコマンドを使用する場合

Claude for Desktopの設定ファイル（claude_desktop_config.json）に以下を追加：

{
  "mcpServers": {
    "pdf-downloader": {
      "command": "python",
      "args": ["-m", "mcp_server_pdf"],
      "cwd": "/path/to/mcp-server-pdf"
    }
  }
}

uvxコマンドを使用する場合（推奨）

{
  "mcpServers": {
    "pdf-downloader": {
      "command": "uvx",
      "args": ["--from", "/path/to/mcp-server-pdf", "mcp-server-pdf"]
    }
  }
}

cwd を設定すると、download_dir 未指定時のデフォルト保存先がそのディレクトリになります。

利用可能なツール

download_pdf

PDFのURLからファイルをダウンロードします。

パラメータ:

• url (必須): ダウンロードするPDFのURL

• filename (オプション): 保存するファイル名。指定しない場合はURLから自動生成

• download_dir (オプション): 保存先ディレクトリのパス。指定しない場合はカレントディレクトリに保存

使用例:

PDFをダウンロードしてください: https://example.com/document.pdf

PDFをダウンロードして、"research_paper.pdf"という名前で保存してください: https://example.com/paper.pdf

pdf_to_markdown

PDFファイルをMarkdown形式に変換します。

パラメータ:

• pdf_path (必須): 変換するPDFファイルのパス

• output_path (オプション): 出力するMarkdownファイルのパス。指定しない場合はPDFと同じディレクトリに.mdファイルを作成

• pages (オプション): 変換するページ範囲（1始まり。例: '1-5', '1,3,5', 'all'）。デフォルトは'all'

• extract_images (オプション): 画像を抽出するかどうか。デフォルトはtrue

技術仕様

• Python 3.13+

• MCP (Model Context Protocol) 1.9.1+

• httpx for HTTP requests

• aiofiles for async file operations

• PyMuPDF4LLM for PDF to Markdown conversion

エラーハンドリング

• 無効なURL

• HTTPエラー（404, 500など）

• タイムアウト

• ファイル保存エラー

• Content-Type検証

• SSRF防止（プライベートネットワークへのアクセスブロック）

ライセンス

MIT License