PDF To PNG

🚀 PDF to PNG MCP Server

A Model Context Protocol (MCP) server that offers the functionality to convert PDFs to PNGs. This server enables you to convert PDF documents into PNG images through simple MCP tool calls.

🚀 Quick Start

Prerequisites

This server requires the Model Context Protocol (MCP). If you're new to MCP, start by installing the SDK:

uv pip install mcp

Additional requirements:

• Python 3.10 or higher
• uv package manager
• poppler (required by pdf2image)

Install Poppler

• Windows: Download and install from poppler-windows.
• macOS: brew install poppler
• Linux: sudo apt-get install poppler-utils

📦 Installation

1. Clone this repository:

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

2. Create and activate a virtual environment:

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

3. Install the package:

uv pip install -e .

💻 Usage Examples

Basic Usage

1. Configure the MCP client

Add the server configuration to your claude_desktop_config.json file. This file is typically located at:

• 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"
      ]
    }
  }
}

Note: Replace /absolute/path/to/mcp-Pdf2png with the actual path where you cloned the repository.

2. Use the server

The server provides a tool pdf2png with the following parameters:

• read_file_path: The absolute path of the input PDF file.
• write_folder_path: The absolute path of the directory where the PNG files will be saved.

Output:

• Each PDF page will be converted into a PNG image.
• The files will be named page_1.png, page_2.png, etc.
• A success message and the number of conversions will be returned.

🤝 Contribution

Contributions are welcome! Feel free to submit a Pull Request.