MCP Pdf2png

🚀 PDF から PNG への MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を利用して、PDF ファイルを PNG 画像に変換する機能を提供します。簡単な MCP ツールの呼び出しで、PDF ドキュメントを PNG 画像に変換できます。

🚀 クイックスタート

このサーバーを使用する前に、いくつかの前提条件を満たす必要があります。また、インストール手順を完了してから、使用方法を確認してください。

✨ 主な機能

• モデルコンテキストプロトコル（MCP）を利用した PDF から PNG への変換機能
• 簡単な MCP ツールの呼び出しで変換を実行できる

📦 インストール

前提条件

このサーバーはモデルコンテキストプロトコル（MCP）が必要です。MCP に不慣れな場合は、SDK のインストールから始めてください。

uv pip install mcp

追加の要件は以下の通りです。

• Python 3.10 以上
• uv パッケージマネージャー
• poppler（pdf2image で必要）

Poppler のインストール

• Windows：poppler-windows からダウンロードしてインストールしてください。
• macOS：brew install poppler
• Linux：sudo apt-get install poppler-utils

インストール手順

1. このリポジトリをクローンします。

   git clone https://github.com/truaxki/mcp-Pdf2png.git
   cd mcp-Pdf2png
   

2. 仮想環境を作成してアクティブ化します。

   uv venv
   # Windows
   .venv\Scripts\activate
   # Unix/macOS
   source .venv/bin/activate
   

3. パッケージをインストールします。

   uv pip install -e .
   

💻 使用例

1. MCP クライアントの設定

サーバーの設定を claude_desktop_config.json ファイルに追加してください。このファイルは通常以下の場所にあります。

• Windows：%APPDATA%\Claude Desktop\config\claude_desktop_config.json
• macOS/Linux：~/.config/Claude Desktop/config/claude_desktop_config.json

{
  "mcpServers": {
    "pdf2png": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/mcp-Pdf2png",
        "run",
        "pdf2png"
      ]
    }
  }
}

注意：/absolute/path/to/mcp-Pdf2png を実際にクローンしたリポジトリのパスに置き換えてください。

2. サーバーの使用

このサーバーは pdf2png ツールを提供しており、以下のパラメーターがあります。

• read_file_path：入力 PDF ファイルの絶対パス
• write_folder_path：PNG ファイルを保存するディレクトリの絶対パス

出力：

• 各 PDF ページが PNG 画像に変換されます。
• ファイル名は page_1.png、page_2.png などとなります。
• 変換数を示す成功メッセージが返されます。

🤝 貢献

貢献を歓迎します！自由に Pull Request を送信してください。