ConvertAPI

MCP de conversão de arquivos de alto desempenho

GitHub
2

Documentação

Servidor MCP ConvertAPI

Nosso servidor MCP hospedado está disponível em https://mcp.convertapi.io - leia mais sobre isso na seção MCP hospedado abaixo.

Um servidor Model Context Protocol (MCP) que fornece aos assistentes de IA poderosas capacidades de conversão de formatos de arquivo através do serviço ConvertAPI. Converta documentos, imagens, planilhas, apresentações e muito mais entre mais de 200 formatos de arquivo com validação de parâmetros orientada por OpenAPI.

Recursos

  • 🔄 Conversão Universal de Arquivos - Converta entre mais de 200 formatos de arquivo (PDF, DOCX, XLSX, JPG, PNG, HTML e outros)
  • ✅ Validação Orientada por OpenAPI - Validação dinâmica de parâmetros contra a especificação OpenAPI ao vivo do ConvertAPI
  • 🎯 Parâmetros Abrangentes - Suporta todos os parâmetros do ConvertAPI, incluindo PageSize, PageOrientation, Quality, StoreFile, etc.
  • 🤖 Pronto para IA - Integra-se perfeitamente com Claude Desktop, Cline e outros assistentes de IA compatíveis com MCP
  • 📦 Local - Suporta operações de arquivos locais

Instalação

Pré-requisitos

Configuração

  1. Clone o repositório:

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

  1. Defina seu Token de API do ConvertAPI como uma variável de ambiente:

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

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

  1. Compile o projeto: dotnet build

Uso

Configuração:

Defina o seguinte na configuração do seu aplicativo:

Modo Local (com download de arquivo): dotnet run --project "CA.MCP.Local"

Integração com Assistentes de IA

Configuração do Claude Desktop

Adicione ao seu 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 (Extensão VSCode)

Adicione às suas configurações MCP no 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"
    }
  }
}

Prefere um MCP Hospedado? (Sem Configuração Necessária)

Se você não quiser instalar o .NET ou executar seu próprio servidor, você pode usar o MCP ConvertAPI hospedado em vez disso.

Endpoint hospedado:

https://mcp.convertapi.io

Basta configurar seu cliente MCP para usar o endpoint hospedado e fornecer seu Token de API do ConvertAPI.

Exemplo (Claude Desktop)

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

É isso. Seu agente de IA pode começar imediatamente a converter documentos em mais de 200 formatos usando chamadas de ferramentas MCP estruturadas.

Se você precisar de controle total, rede privada ou implantação personalizada, continue com a configuração auto-hospedada.

Ferramentas Disponíveis

Convert

Converte dinamicamente arquivos entre formatos com validação de parâmetros orientada por OpenAPI.

Parâmetros:

  • fromFormat (obrigatório) - Formato de origem (ex.: "docx", "xlsx", "jpg")
  • toFormat (obrigatório) - Formato de destino (ex.: "pdf", "png", "html")
  • parameters (opcional) - Parâmetros de conversão como pares chave-valor
  • fileParameters (opcional) - Arquivos para converter com nomes de parâmetros
  • outputDirectory (opcional) - Diretório para salvar arquivos convertidos (somente modo Local)

Exemplo de Uso em Assistente de IA:

Converta este documento do Word para PDF: • De: docx • Para: pdf • Arquivo: C:\Documents\report.docx • Parâmetros: PageSize=A4, PageOrientation=portrait

Information

Fornece informações sobre as capacidades do ConvertAPI, formatos suportados e diretrizes de uso.

Conversões Suportadas

O ConvertAPI suporta mais de 200 formatos de arquivo em várias categorias:

  • Documentos: PDF, DOCX, DOC, RTF, TXT, ODT, PAGES
  • Planilhas: XLSX, XLS, CSV, ODS, NUMBERS
  • Apresentações: PPTX, PPT, ODP, KEY
  • Imagens: JPG, PNG, GIF, BMP, TIFF, SVG, WEBP, ICO
  • Web: HTML, MHTML, MHT
  • eBooks: EPUB, MOBI, AZW3
  • Arquivos: ZIP, RAR, 7Z
  • E muitos outros...

Parâmetros Comuns de Conversão

Dependendo do tipo de conversão, você pode usar parâmetros como:

  • Opções de PDF: PageSize, PageOrientation, MarginTop, MarginBottom, MarginLeft, MarginRight
  • Opções de Imagem: Quality, ImageWidth, ImageHeight, ScaleImage, ScaleProportions
  • Geral: StoreFile, FileName, Timeout

O servidor valida automaticamente os parâmetros contra a especificação OpenAPI do ConvertAPI antes da conversão.

Plugin Claude Code

Além de um servidor MCP auto-hospedado, este repositório fornece um plugin Claude Code que conecta o Claude ao ConvertAPI via MCP.

O que ele permite

  • Converter arquivos entre diferentes formatos diretamente do Claude
  • Automatizar processamento, extração e transformações de documentos e imagens

Exemplo de uso

  • "Converta este PDF para DOCX"
  • "Mescle estes arquivos PDF e aplique uma marca d'água [Rascunho]"
  • "Redija informações financeiras confidenciais neste PDF"
  • "Torne este PDF pronto para impressão com sangria e marcas de corte"

Configuração

  • Instale o plugin no Claude Code
  • Autentique via OAuth

Contribuindo

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

Licença

Este projeto é licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

Recursos

Agradecimentos

Suporte

Para problemas e dúvidas: