PDF.co MCP

Realiza diversas tareas de procesamiento de PDF utilizando la API de PDF.co.

Documentación

PDF.co MCP

El servidor PDF.co MCP proporciona la funcionalidad de la API de PDF.co a través del Protocolo de Contexto de Modelo (MCP), permitiendo a los asistentes de IA realizar fácilmente diversas tareas de procesamiento de PDF.

🚀 Características Principales

📄 Herramientas de Conversión de PDF

PDF → Varios Formatos: Convierte PDFs a JSON, CSV, Texto, Excel (XLS/XLSX), XML, HTML, Imágenes (JPG/PNG/WebP/TIFF)
Varios Formatos → PDF: Convierte documentos (DOC/DOCX/RTF/TXT), hojas de cálculo (CSV/XLS/XLSX), imágenes, páginas web, HTML, correos electrónicos (MSG/EML) a PDF
Conversiones de Excel: Convierte archivos de Excel a CSV, JSON, HTML, TXT, XML, PDF

🛠️ Edición y Modificación de PDF

Fusión de PDFs: Combina múltiples archivos PDF en uno solo
División de PDFs: Divide PDFs por páginas específicas o rangos de páginas
Añadir Anotaciones e Imágenes: Añade texto, enlaces, imágenes y formas a los PDFs
Operaciones con Formularios: Lee información de campos de formularios PDF, rellena formularios, crea nuevos elementos de formulario

🔍 Búsqueda y Análisis de PDF

Búsqueda de Texto: Busca texto en PDFs (admite expresiones regulares)
Detección de Tablas: Encuentra ubicaciones y coordenadas de tablas en PDFs
Analizador de Facturas con IA: Extrae datos de facturas utilizando IA
Información del PDF: Obtén información detallada que incluye metadatos, número de páginas, información de seguridad

🔒 Seguridad y Accesibilidad

Protección con Contraseña: Añade/elimina protección con contraseña a los PDFs
Capacidad de Búsqueda: Haz que los PDFs sean buscables mediante OCR o elimina capas de texto
Extracción de Adjuntos: Extrae adjuntos de los PDFs

💼 Gestión de Archivos

Carga de Archivos: Sube archivos locales a los servidores de PDF.co
Seguimiento de Estado de Trabajos: Monitorea el progreso y los resultados de operaciones asíncronas

⚙️ Configuración

🔑 Obtener Clave de API

Regístrate en el sitio web de PDF.co
Obtén tu clave de API desde el panel de control

📦 Instalar UV

Necesitas instalar UV (una herramienta rápida de empaquetado de Python) para usar este servidor MCP:

macOS y Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Métodos de Instalación Alternativos

Homebrew: brew install uv
PyPI con pipx: pipx install uv
PyPI con pip: pip install uv

Para más opciones de instalación y detalles, consulta la guía de instalación de UV.

Configuración del Servidor MCP

Configuración de Cursor IDE

Añade lo siguiente a tu archivo .cursor/mcp.json:

{
  "mcpServers": {
    "pdfco": {
      "command": "uvx",
      "args": ["pdfco-mcp"],
      "env": {
        "X_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Configuración de Claude Desktop

Añade lo siguiente a tu archivo claude_desktop_config.json:

{
  "mcpServers": {
    "pdfco": {
      "command": "uvx",
      "args": ["pdfco-mcp"],
      "env": {
        "X_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

🔧 Herramientas Disponibles

Herramientas de Conversión de PDF

pdf_to_json: Convierte PDF e imágenes escaneadas a una representación JSON con texto, fuentes, imágenes, vectores y formato preservados
pdf_to_csv: Convierte PDF e imágenes escaneadas a una representación CSV con diseño, columnas, filas y tablas
pdf_to_text: Convierte PDF e imágenes escaneadas a texto con el diseño preservado
pdf_to_xls: Convierte PDF e imágenes escaneadas al formato XLS (Excel 97-2003)
pdf_to_xlsx: Convierte PDF e imágenes escaneadas al formato XLSX (Excel 2007+)
pdf_to_xml: Convierte PDF e imágenes escaneadas al formato XML
pdf_to_html: Convierte PDF e imágenes escaneadas al formato HTML
pdf_to_image: Convierte PDF e imágenes escaneadas a varios formatos de imagen (JPG, PNG, WebP, TIFF)

Herramientas de Conversión de Documentos a PDF

document_to_pdf: Convierte varios tipos de documentos (DOC, DOCX, RTF, TXT, XLS, XLSX, CSV, HTML, JPG, PNG, TIFF, WEBP) a PDF
csv_to_pdf: Convierte archivos CSV u hojas de cálculo (XLS, XLSX) a PDF
image_to_pdf: Convierte varios formatos de imagen (JPG, PNG, TIFF) a PDF
webpage_to_pdf: Convierte la URL de una página web externa a PDF
html_to_pdf: Convierte HTML a PDF
email_to_pdf: Convierte correos electrónicos a PDF

Herramientas de Conversión de Excel

excel_to_csv: Convierte Excel (XLS, XLSX) a CSV
excel_to_json: Convierte Excel (XLS, XLSX) a JSON
excel_to_html: Convierte Excel (XLS, XLSX) a HTML
excel_to_txt: Convierte Excel (XLS, XLSX) a TXT
excel_to_xml: Convierte Excel (XLS, XLSX) a XML
excel_to_pdf: Convierte Excel (XLS, XLSX) a PDF

Herramientas de Edición de PDF

pdf_add_annotations_images_fields: Añade texto, imágenes, formularios, otros PDFs, rellena formularios, enlaces a sitios externos y archivos PDF externos. Puedes actualizar o modificar archivos PDF y PDF escaneados
pdf_merge: Fusiona PDF a partir de dos o más PDF, DOC, XLS, imágenes, incluso ZIP con documentos e imágenes en un nuevo PDF
pdf_split: Divide un PDF en múltiples archivos PDF usando índices de página o rangos de páginas

Herramientas de Formularios PDF

read_pdf_forms_info: Extrae información sobre campos PDF rellenables de un archivo PDF de entrada
fill_pdf_forms: Rellena campos de formulario existentes en un documento PDF
create_fillable_forms: Crea nuevos elementos de formulario rellenables en un documento PDF

Herramientas de Búsqueda en PDF

find_text: Busca texto en PDF y obtén coordenadas. Admite expresiones regulares
find_table: Encuentra tablas en PDF y obtén sus coordenadas

Herramientas de Análisis de PDF

ai_invoice_parser: Analizador de Facturas con IA: Extrae datos de facturas utilizando IA
extract_attachments: Extrae adjuntos de un archivo PDF de origen
pdf_info_reader: Obtén información detallada sobre un documento PDF: número de páginas, metadatos, seguridad, campos de formulario y más

Herramientas de Seguridad de PDF

pdf_add_password: Añade protección con contraseña a un archivo PDF
pdf_remove_password: Elimina la protección con contraseña de un archivo PDF

Herramientas de Capacidad de Búsqueda de PDF

pdf_make_searchable: Convierte documentos PDF escaneados o archivos de imagen en un PDF con texto buscable. Ejecuta OCR y añade una capa de texto invisible que puede usarse para búsqueda de texto
pdf_make_unsearchable: Haz que un documento PDF existente no sea buscable eliminando la capa de texto

Herramientas de Gestión de Archivos

upload_file: Sube un archivo a la API de PDF.co
get_job_check: Verifica el estado y los resultados de un trabajo. El estado puede ser: trabajando, éxito, fallido, abortado o desconocido
wait_job_completion: Espera a que un trabajo se complete

📖 Ejemplos de Uso

Convertir PDF a Texto

Convert this PDF file to text: https://example.com/document.pdf

Fusionar Múltiples Imágenes en PDF

Create a PDF from these images: image1.jpg, image2.png, image3.jpg

Buscar Texto Específico en PDF

Find the word "contract" in this PDF document

Rellenar Campos de Formulario PDF

Fill the name field in this PDF form with "John Doe"

Convertir Página Web a PDF

Convert https://example.com webpage to PDF

Extraer Datos de Facturas

Extract invoice information from this PDF using AI

Añadir Protección con Contraseña

Add password protection to this PDF file

📞 Soporte y Contacto

PDF.co: https://pdf.co
Documentación de la API de PDF.co: https://developer.pdf.co
Informe de Problemas: Informa problemas a través de GitHub Issues

📄 Licencia

Este proyecto se distribuye bajo la Licencia MIT.

Nota: Se requiere una clave de API válida de PDF.co para usar esta herramienta. Crea una cuenta gratuita en PDF.co para obtener tu clave de API.