MCP-PDF2MD

MCP-PDF2MD

Servicio MCP-PDF2MD

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

Características principales

• Conversión de formato: Convierte archivos PDF a formato Markdown estructurado.
• Soporte de múltiples fuentes: Procesa tanto archivos PDF locales como URL de PDF remotos.
• Integración MCP: Se integra perfectamente con clientes LLM como Claude Desktop.
• Preservación de estructura: Tiene como objetivo mantener la estructura del documento original, incluidos encabezados, párrafos y listas.
• Extracción de imágenes: Extrae automáticamente imágenes del PDF y las guarda localmente.
• Extracción de alta calidad: Aprovecha el OCR de última generación de Mistral AI para una extracción de texto e información de diseño de alta calidad.

Requisitos del sistema

• Python 3.10+
• uv para gestión de entornos y paquetes (recomendado)

Inicio rápido

1. Clona el repositorio y entra en el directorio:

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

2. Instala las dependencias con uv:

   uv sync
   

3. Configura las variables de entorno:

   Crea un archivo .env en el directorio raíz del proyecto y establece tu clave de API de Mistral AI:

   MISTRAL_API_KEY=your_mistral_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:

• --output-dir: Especifica el directorio para guardar los archivos Markdown convertidos y las imágenes. El valor predeterminado es ./downloads.

Ejemplo:

uv run pdf2md --output-dir /path/to/my/output

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": {
        "MISTRAL_API_KEY": "your_mistral_api_key_here"
      }
    }
  }
}

Linux/macOS:

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

Nota sobre la configuración de la clave de API: Puedes establecer la clave de 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 regular).

Si estableces la clave de 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(url: str): Convierte un PDF desde una URL a Markdown. Admite URL individuales o múltiples URL separadas por espacios, comas o saltos de línea.
• convert_pdf_file(file_path: str): Convierte un archivo PDF local a Markdown. Admite rutas de archivo individuales o múltiples separadas por espacios, comas o saltos de línea.

Obtener una clave de API de Mistral AI

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

1. Visita la Plataforma Mistral AI y crea una cuenta.
2. Navega a la sección "API Keys" en tu espacio de trabajo.
3. Crea una nueva clave secreta.
4. Copia la clave de API generada.
5. Usa esta clave como valor para MISTRAL_API_KEY.

Licencia

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

Créditos

Este proyecto utiliza la API OCR de Mistral AI.