PDF to PNG

Servidor MCP de PDF a PNG

Un servidor de Model Context Protocol (MCP) que proporciona capacidades de conversión de PDF a PNG. Este servidor te permite convertir documentos PDF en imágenes PNG con una simple llamada a la herramienta MCP.

Requisitos previos

Este servidor requiere el Model Context Protocol (MCP). Si eres nuevo en MCP, comienza instalando el SDK:

uv pip install mcp

Requisitos adicionales:

• Python 3.10 o superior
• Gestor de paquetes uv
• poppler (requerido para pdf2image)

Instalación de Poppler

• Windows: Descarga e instala desde poppler-windows
• macOS: brew install poppler
• Linux: sudo apt-get install poppler-utils

Instalación

1. Clona este repositorio:

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

2. Crea y activa un entorno virtual:

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

3. Instala el paquete:

   uv pip install -e .
   

Uso

1. Configurar el Cliente MCP

Añade la configuración del servidor a tu claude_desktop_config.json. El archivo se encuentra típicamente en:

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

Nota: Reemplaza /absolute/path/to/mcp-Pdf2png con la ruta real donde clonaste el repositorio.

2. Usar el Servidor

El servidor proporciona una única herramienta pdf2png con estos parámetros:

• read_file_path: Ruta absoluta al archivo PDF de entrada
• write_folder_path: Ruta absoluta al directorio donde se deben guardar los archivos PNG

Salida:

• Cada página del PDF se convierte en una imagen PNG
• Los archivos se nombran page_1.png, page_2.png, etc.
• Devuelve un mensaje de éxito con el número de conversiones

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.