PDF to PNG

PDF to PNG MCP Server

Um servidor Model Context Protocol (MCP) que fornece capacidades de conversão de PDF para PNG. Este servidor permite converter documentos PDF em imagens PNG com uma simples chamada de ferramenta MCP.

Pré-requisitos

Este servidor requer o Model Context Protocol (MCP). Se você é novo no MCP, comece instalando o SDK:

uv pip install mcp

Requisitos adicionais:

• Python 3.10 ou superior
• uv gerenciador de pacotes
• poppler (necessário para pdf2image)

Instalando o Poppler

• Windows: Baixe e instale de poppler-windows
• macOS: brew install poppler
• Linux: sudo apt-get install poppler-utils

Instalação

1. Clone este repositório:

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

2. Crie e ative um ambiente virtual:

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

3. Instale o pacote:

   uv pip install -e .
   

Uso

1. Configure o Cliente MCP

Adicione a configuração do servidor ao seu claude_desktop_config.json. O arquivo geralmente está localizado em:

• 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: Substitua /absolute/path/to/mcp-Pdf2png pelo caminho real onde você clonou o repositório.

2. Usando o Servidor

O servidor fornece uma única ferramenta pdf2png com estes parâmetros:

• read_file_path: Caminho absoluto para o arquivo PDF de entrada
• write_folder_path: Caminho absoluto para o diretório onde os arquivos PNG devem ser salvos

Saída:

• Cada página do PDF é convertida em uma imagem PNG
• Os arquivos são nomeados page_1.png, page_2.png, etc.
• Retorna uma mensagem de sucesso com a contagem de conversões

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.