MCP-PDF2MD

MCP-PDF2MD

English | 中文

Servicio MCP-PDF2MD

Un servicio de conversión de PDF a Markdown de alto rendimiento basado en MCP, impulsado por la API de MinerU, que admite procesamiento por lotes para archivos locales y enlaces URL con salida estructurada.

Características principales

• Conversión de formato: Convierte archivos PDF a formato Markdown estructurado.
• Soporte multi-fuente: Procesa tanto archivos PDF locales como enlaces URL.
• Procesamiento inteligente: Selecciona automáticamente el mejor método de procesamiento.
• Procesamiento por lotes: Admite conversión por lotes de múltiples archivos para manejar eficientemente grandes volúmenes de PDF.
• Integración MCP: Integración perfecta con clientes LLM como Claude Desktop.
• Preservación de estructura: Mantiene la estructura original del documento, incluidos encabezados, párrafos, listas, etc.
• Diseño inteligente: Genera texto en orden legible para humanos, adecuado para diseños de una columna, múltiples columnas y complejos.
• Conversión de fórmulas: Reconoce y convierte automáticamente las fórmulas del documento a formato LaTeX.
• Extracción de tablas: Reconoce y convierte automáticamente las tablas del documento a formato estructurado.
• Optimización de limpieza: Elimina encabezados, pies de página, notas al pie, números de página, etc., para garantizar la coherencia semántica.
• Extracción de alta calidad: Extracción de alta calidad de texto, imágenes e información de diseño de documentos PDF.

Requisitos del sistema

• Software: Python 3.10+

Inicio rápido

1. Clona el repositorio y entra en el directorio:

   git clone https://github.com/FutureUnreal/mcp-pdf2md.git
   cd mcp-pdf2md
   

2. Crea un entorno virtual e instala las dependencias:

   Linux/macOS:

   uv venv
   source .venv/bin/activate
   uv pip install -e .
   

   Windows:

   uv venv
   .venv\Scripts\activate
   uv pip install -e .
   

3. Configura las variables de entorno:

   Crea un archivo .env en el directorio raíz del proyecto y establece las siguientes variables de entorno:

   MINERU_API_BASE=https://mineru.net/api/v4/extract/task
   MINERU_BATCH_API=https://mineru.net/api/v4/extract/task/batch
   MINERU_BATCH_RESULTS_API=https://mineru.net/api/v4/extract-results/batch
   MINERU_API_KEY=your_api_key_here
   

4. Inicia el servicio:

   uv run pdf2md
   

Argumentos de línea de comandos

El servidor admite los siguientes argumentos de línea de comandos:

Configuración de Claude Desktop

Añade la siguiente configuración en Claude Desktop:

Windows:

{
    "mcpServers": {
        "pdf2md": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\path\\to\\mcp-pdf2md",
                "run",
                "pdf2md",
                "--output-dir",
                "C:\\path\\to\\output"
            ],
            "env": {
                "MINERU_API_KEY": "your_api_key_here"
            }
        }
    }
}

Linux/macOS:

{
    "mcpServers": {
        "pdf2md": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-pdf2md",
                "run",
                "pdf2md",
                "--output-dir",
                "/path/to/output"
            ],
            "env": {
                "MINERU_API_KEY": "your_api_key_here"
            }
        }
    }
}

Nota sobre la configuración de la clave API: Puedes configurar la clave API de dos maneras:

1. En el archivo .env dentro del directorio del proyecto (recomendado para desarrollo)
2. En la configuración de Claude Desktop como se muestra arriba (recomendado para uso habitual)

Si configuras la clave API en ambos lugares, la de la configuración de Claude Desktop tendrá prioridad.

Herramientas MCP

El servidor proporciona las siguientes herramientas MCP:

• convert_pdf_url: Convierte una URL de PDF a Markdown
• convert_pdf_file: Convierte un archivo PDF local a Markdown

Obtención de la clave API de MinerU

Este proyecto depende de la API de MinerU para la extracción de contenido PDF. Para obtener una clave API:

1. Visita el sitio web oficial de MinerU y regístrate para crear una cuenta
2. Después de iniciar sesión, solicita la calificación de prueba de API en este enlace
3. Una vez que tu solicitud sea aprobada, puedes acceder a la página de Gestión de API
4. Genera tu clave API siguiendo las instrucciones proporcionadas
5. Copia la clave API generada
6. Usa esta cadena como valor para MINERU_API_KEY

Ten en cuenta que el acceso a la API de MinerU se encuentra actualmente en fase de pruebas y requiere la aprobación del equipo de MinerU. El proceso de aprobación puede llevar algún tiempo, así que planifícalo en consecuencia.

Demostración

PDF de entrada

Markdown de salida

Licencia

Licencia MIT: consulta el archivo LICENSE para obtener más detalles.

Créditos

Este proyecto se basa en la API de MinerU.