MCP Pdf2png

🚀 PDF to PNG MCP Server

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

🚀 Quick Start

✨ Features

• Convert PDF documents to PNG images via MCP tool calls.

📦 Installation

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 Steps

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 to save the PNG files.

Output:

• Each PDF page is converted to a PNG image.
• The files are named page_1.png, page_2.png, etc.
• A success message is returned, showing the number of conversions.

🤝 Contribution

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