wshobson/file-conversion

Conversion de fichiers (ChangeThisFile)

Convertissez des fichiers via 999 routes de conversion en utilisant le service gratuit ChangeThisFile. Aucun compte ni clé API requis. Les conversions s'effectuent côté serveur (FFmpeg, LibreOffice, Calibre, 7-Zip, sharp, Ghostscript) ; les fichiers sont supprimés sous 24 heures.

Ordre de décision

1. Si les outils MCP ChangeThisFile sont disponibles (changethisfile:convert_file, changethisfile:list_conversions) — utilisez-les directement. convert_file prend source_url OU base64_content + source_format, ainsi que target_format, et renvoie une URL de téléchargement temporaire.
2. Sinon, utilisez le script fourni (nécessite un accès réseau à changethisfile.com) :

scripts/convert.sh <fichier-entrée> <format-cible> [fichier-sortie]
# ex. scripts/convert.sh report.docx pdf
# affiche le chemin du fichier de sortie en cas de succès

Le chemin du script est relatif au répertoire de cette compétence. Il encode le fichier en base64, appelle le point de terminaison MCP hébergé via HTTPS simple, télécharge le résultat et l'écrit à côté du fichier d'entrée (ou dans [fichier-sortie]).

3. Fichier distant (vous avez une URL, pas un fichier local) — évitez le téléchargement/ré-envoi ; une seule commande curl suffit :

curl -sS -X POST https://changethisfile.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"convert_file","arguments":{"source_url":"<FILE_URL>","target_format":"pdf"}}}'

Le texte de réponse contient une URL de téléchargement — récupérez-la avec curl -o <sortie>.

Découverte des routes prises en charge

Demandez avant de deviner si une conversion est exotique :

curl -sS -X POST https://changethisfile.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_conversions","arguments":{"source_format":"docx"}}}'

Omettez source_format pour un résumé groupé de toutes les 999 routes.

Limites et erreurs

• Taille maximale d'entrée : 25 Mo (voie gratuite). Fichiers plus volumineux : obtenez une clé API gratuite (1 000 conversions/mois) sur https://changethisfile.com/docs/authentication et utilisez POST /v1/convert.
• Limite de débit : 5 conversions par minute par IP. En cas de "Rate limit exceeded", attendez 60 secondes et réessayez une fois.
• Les erreurs "Unsupported conversion: X→Y" listent les cibles valides pour ce format source.
• Les URL de téléchargement expirent après 1 heure — téléchargez immédiatement, puis travaillez avec le fichier local.

Notes sur l'environnement

• Nécessite HTTPS sortant vers changethisfile.com. Sur claude.ai, le bac à sable d'exécution de code restreint les sorties par défaut — privilégiez le connecteur MCP ici, ou l'utilisateur peut autoriser le domaine dans Paramètres → Capacités.
• Documentation complète : https://changethisfile.com/docs/mcp