Fiche vérifiée le 31 octobre 2026 · Canal production · Meteor Factory
Pourquoi utiliser Image Tools ?
Pour les développeurs et les agents qui préparent des images pour le Web, Image Tools convertit les fichiers directement pendant une exécution MCP, sans service distant.
Ce que vous pouvez faire
Convertir vers PNG, JPG, WebP ou AVIF.
Choisir la qualité et le chemin de sortie ; protéger les fichiers existants.
Lire le format cible, les dimensions, la taille et la durée dans le résultat MCP.
HEIC/HEIF sont acceptés en entrée, pas en sortie. Le plugin expose un outil MCP sans page propre.
Prérequis et activation
Dans Singularity 2.x, ouvrez le Marketplace, cherchez Image Tools, puis installez-le. Acceptez les permissions de transformation des images dans l’espace de travail et d’exposition MCP. Activez le plugin avec son interrupteur. Ouvrez un espace de travail accessible en lecture et écriture ; lancez un agent disposant de l’outil image_convert. Aucun compte, clé API ou réglage propre au plugin n’est nécessaire.
Premier résultat : PNG vers WebP
- Créez
demo.pngdans la racine de cet espace avec Python 3 (uniquement nécessaire pour cette petite image de test). Exécutez la commande ci-dessous dans son terminal.
python3 - <<'PY'
import struct, zlib
from pathlib import Path
def chunk(kind, data):
return struct.pack(">I", len(data)) + kind + data + struct.pack(">I", zlib.crc32(kind + data))
w, h = 320, 200
pixels = (b"\x00" + bytes([38, 132, 255]) * w) * h
Path("demo.png").write_bytes(b"\x89PNG\r\n\x1a\n" + chunk(b"IHDR", struct.pack(">IIBBBBB", w, h, 8, 2, 0, 0, 0)) + chunk(b"IDAT", zlib.compress(pixels)) + chunk(b"IEND", b""))
PY
- Demandez à l’agent d’appeler
image_convertavec cette entrée JSON. Les chemins relatifs partent de l’espace de travail autorisé ; un chemin absolu doit rester dans ce même espace.
{"source":"demo.png","target":"webp","quality":85}
- Le résultat indique
output: "demo.webp",target: "webp",width: 320etheight: 200.bytesest la taille réellement écrite etdurationMsvarie selon la machine. Ouvrezdemo.webpdepuis l’explorateur de Singularity : l’aperçu affiche l’image bleue, 320 × 200 pixels.
Variante : collision et remplacement
Relancez exactement le même appel. Le message output file already exists protège la première image. Pour une autre copie, utilisez un nouveau chemin ; les dossiers de sortie sont créés automatiquement.
{"source":"demo.png","target":"jpg","output":"exports/demo.jpg","quality":70}
Pour remplacer volontairement une sortie existante, ajoutez "overwrite": true. La source et la sortie doivent toujours être différentes.
Options et configuration
source et target sont obligatoires. target accepte png, jpg, webp, avif. Sans output, la dernière extension de la source est remplacée. quality accepte un nombre de 1 à 100 (85 par défaut) pour JPG/WebP/AVIF ; PNG utilise une compression fixe. overwrite vaut false par défaut. JPG remplace la transparence par du blanc. Pas de redimensionnement, recadrage, génération ou traitement par lot.
Limites et dépannage
Entrées annoncées : PNG, JPG, WebP, AVIF, HEIC/HEIF, GIF, TIFF et SVG. HEIC/HEIF ne sont pas des cibles de sortie. Cette recette exerce PNG → WebP et PNG → JPG, pas tous les décodeurs ni les fichiers animés/multipages. Limites : 25 Mio en entrée, 50 Mio en sortie, 40 millions de pixels. Les chemins hors espace de travail et les liens symboliques sont refusés.
Si l’outil manque, vérifiez installation, activation et consentement MCP. source file not found : vérifiez le chemin et l’espace actif. unsupported or invalid image format : ouvrez la source et vérifiez son format réel. Une qualité hors intervalle ou une cible heic est refusée avant conversion. Une permission refusée empêche l’appel ; autorisez-la dans le Marketplace.
Captures de qualification
Image Tools 1.0.14 · 320 × 200 · PNG → WebP / JPG.
Continuer avec Singularity
Ce plugin s’utilise dans un espace de travail Singularity. Consultez les permissions et les conditions de licence dans le Marketplace avant de l’activer.