ConvertAPI

MCP de conversión de archivos de alto rendimiento

GitHub
2

Documentación

Servidor MCP de ConvertAPI

Nuestro servidor MCP alojado está disponible en https://mcp.convertapi.io - lee más al respecto en la sección de MCP alojado a continuación.

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona a los asistentes de IA potentes capacidades de conversión de formatos de archivo a través del servicio ConvertAPI. Convierte documentos, imágenes, hojas de cálculo, presentaciones y más entre más de 200 formatos de archivo con validación de parámetros impulsada por OpenAPI.

Características

  • 🔄 Conversión Universal de Archivos - Convierte entre más de 200 formatos de archivo (PDF, DOCX, XLSX, JPG, PNG, HTML y más)
  • ✅ Validación Impulsada por OpenAPI - Validación dinámica de parámetros contra la especificación OpenAPI en vivo de ConvertAPI
  • 🎯 Parámetros Integrales - Soporta todos los parámetros de ConvertAPI, incluyendo PageSize, PageOrientation, Quality, StoreFile, etc.
  • 🤖 Listo para IA - Se integra perfectamente con Claude Desktop, Cline y otros asistentes de IA compatibles con MCP
  • 📦 Local - Soporta operaciones de archivos locales

Instalación

Requisitos previos

  • SDK de .NET 9.0 o posterior
  • Una cuenta de ConvertAPI y Token de API (Obtén uno gratis)

Configuración

  1. Clona el repositorio:

git clone https://github.com/ConvertAPI/convertapi-mcp cd ConvertAPI-MCP

  1. Establece tu Token de API de ConvertAPI como variable de entorno:

Windows (PowerShell): $env:CONVERTAPI_TOKEN = "tu_token_de_api_aqui" $env:CONVERTAPI_BASE_URI = "https://v2.convertapi.com"

Linux/macOS: export CONVERTAPI_TOKEN="tu_token_de_api_aqui" export CONVERTAPI_BASE_URI="https://v2.convertapi.com"

  1. Compila el proyecto: dotnet build

Uso

Configuración:

Establece lo siguiente en la configuración de tu aplicación:

Modo Local (con descarga de archivos): dotnet run --project "CA.MCP.Local"

Integración con Asistentes de IA

Configuración de Claude Desktop

Agrega a tu claude_desktop_config.json:

{
  "mcpServers": {
    "convertapi": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "C:\\Path\\To\\CA.MCP.Local\\CA.MCP.Local.csproj",
        "--no-build"
      ],
      "env": {
        "CONVERTAPI_TOKEN": "your_api_token_here",
        "CONVERTAPI_BASE_URI": "https://v2.convertapi.com"
      }
    }
  }
}

Cline (Extensión de VSCode)

Agrega a tu configuración de MCP en Cline:

{
  "convertapi": {
    "command": "dotnet",
    "args": [
      "run",
      "--project",
      "/path/to/CA.MCP.Local",
      "--no-build"
    ],
    "env": {
      "CONVERTAPI_TOKEN": "your_api_token_here",
      "CONVERTAPI_BASE_URI": "https://v2.convertapi.com"
    }
  }
}

¿Prefieres un MCP Alojado? (Sin Configuración Requerida)

Si no deseas instalar .NET o ejecutar tu propio servidor, puedes usar el MCP de ConvertAPI alojado en su lugar.

Endpoint alojado:

https://mcp.convertapi.io

Solo configura tu cliente MCP para usar el endpoint alojado y proporciona tu Token de API de ConvertAPI.

Ejemplo (Claude Desktop)

{
  "mcpServers": {
    "convertapi": {
      "url": "https://mcp.convertapi.io",
      "env": {
        "CONVERTAPI_TOKEN": "your_api_token_here"
      }
    }
  }
}

Eso es todo. Tu agente de IA puede comenzar inmediatamente a convertir documentos en más de 200 formatos utilizando llamadas de herramientas MCP estructuradas.

Si necesitas control total, redes privadas o implementación personalizada, continúa con la configuración autohospedada.

Herramientas Disponibles

Convert

Convierte dinámicamente archivos entre formatos con validación de parámetros impulsada por OpenAPI.

Parámetros:

  • fromFormat (requerido) - Formato de origen (ej., "docx", "xlsx", "jpg")
  • toFormat (requerido) - Formato de destino (ej., "pdf", "png", "html")
  • parameters (opcional) - Parámetros de conversión como pares clave-valor
  • fileParameters (opcional) - Archivos a convertir con nombres de parámetros
  • outputDirectory (opcional) - Directorio para guardar los archivos convertidos (solo modo Local)

Ejemplo de Uso en Asistente de IA:

Convierte este documento de Word a PDF: • De: docx • A: pdf • Archivo: C:\Documentos\informe.docx • Parámetros: PageSize=A4, PageOrientation=portrait

Information

Proporciona información sobre las capacidades de ConvertAPI, formatos compatibles y pautas de uso.

Conversiones Compatibles

ConvertAPI soporta más de 200 formatos de archivo en múltiples categorías:

  • Documentos: PDF, DOCX, DOC, RTF, TXT, ODT, PAGES
  • Hojas de cálculo: XLSX, XLS, CSV, ODS, NUMBERS
  • Presentaciones: PPTX, PPT, ODP, KEY
  • Imágenes: JPG, PNG, GIF, BMP, TIFF, SVG, WEBP, ICO
  • Web: HTML, MHTML, MHT
  • Libros electrónicos: EPUB, MOBI, AZW3
  • Archivos comprimidos: ZIP, RAR, 7Z
  • Y muchos más...

Parámetros de Conversión Comunes

Dependiendo del tipo de conversión, puedes usar parámetros como:

  • Opciones de PDF: PageSize, PageOrientation, MarginTop, MarginBottom, MarginLeft, MarginRight
  • Opciones de Imagen: Quality, ImageWidth, ImageHeight, ScaleImage, ScaleProportions
  • Generales: StoreFile, FileName, Timeout

El servidor valida automáticamente los parámetros contra la especificación OpenAPI de ConvertAPI antes de la conversión.

Plugin de Claude Code

Además de un servidor MCP autohospedado, este repositorio proporciona un plugin de Claude Code que conecta a Claude con ConvertAPI a través de MCP.

Lo que permite

  • Convertir archivos entre diferentes formatos directamente desde Claude
  • Automatizar el procesamiento, extracción y transformación de documentos e imágenes

Ejemplo de uso

  • "Convierte este PDF a DOCX"
  • "Combina estos archivos PDF y aplica una marca de agua [Borrador]"
  • "Redacta información financiera sensible en este PDF"
  • "Haz que este PDF esté listo para impresión con sangrado y marcas de corte"

Configuración

  • Instala el plugin en Claude Code
  • Autentícate mediante OAuth

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

Recursos

Agradecimientos

Soporte

Para problemas y preguntas: