Serveur MCP CleverUtils

Point de terminaison du serveur

Le serveur MCP parle JSON-RPC 2.0 sur HTTP à l'adresse :

https://cleverutils.com/mcp

Il implémente le transport Streamable HTTP (POST pour les requêtes JSON-RPC). Pas d'état de session, pas d'authentification, limité par IP à 1000 requêtes par jour.

Se connecter depuis Claude Desktop

{
  "mcpServers": {
    "cleverutils": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://cleverutils.com/mcp"]
    }
  }
}

{
  "mcpServers": {
    "cleverutils": {
      "url": "https://cleverutils.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "cleverutils": {
      "url": "https://cleverutils.com/mcp"
    }
  }
}

Outils disponibles

Le serveur expose 15 outils. Toutes les entrées d'outils acceptent soit une URL HTTPS (le serveur la récupère avec protection SSRF), soit un fichier encodé en base64. Les sorties sont renvoyées sous forme de blocs MCP resource_link pointant vers une URL de téléchargement valide 2 heures.

Exemples de prompts

Une fois connecté, vous pouvez demander au LLM des choses comme :

• « Convertis https://example.com/photo.heic en JPG. »
• « Agrandis cette image 4x : https://example.com/icon.png »
• « Supprime l'arrière-plan de https://example.com/portrait.jpg et donne-moi le PNG transparent. »
• « Transcris ce podcast en sous-titres SRT en anglais : https://example.com/episode.mp3 »
• « Compresse ce PDF à environ 50% de sa taille d'origine : https://example.com/report.pdf »
• « Fusionne ces trois PDF en un seul : https://…/a.pdf, https://…/b.pdf, https://…/c.pdf »

Comment ça fonctionne

1. Le LLM choisit un outil. En fonction de votre requête, le LLM consulte la liste des outils et en choisit un (par ex. upscale_image) avec les bons arguments.
2. Le serveur récupère le fichier. Si vous passez une URL, le serveur la télécharge côté serveur — derrière une liste de blocage SSRF stricte (pas d'IP privées, pas de file://, pas de DNS rebinding).
3. La conversion s'exécute. Le même moteur que notre site web et notre API REST : ImageMagick, FFmpeg, Real-ESRGAN, Demucs, Whisper, Ghostscript, LibreOffice.
4. Le résultat est renvoyé comme lien de ressource. Le LLM reçoit une réponse structurée contenant à la fois du texte lisible (« Fichier converti : photo.jpg, 180 Ko ») et un resource_link lisible par machine avec une URL de téléchargement valide 2 heures.

Testez-le depuis votre terminal

Si vous voulez juste vérifier que le serveur fonctionne sans configurer un client MCP complet, essayez ce curl :

curl -X POST https://cleverutils.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": {"name": "curl", "version": "1.0"}
    }
  }'

curl -X POST https://cleverutils.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

curl -X POST https://cleverutils.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "convert_file",
      "arguments": {
        "file": "https://example.com/photo.heic",
        "to_format": "jpg"
      }
    }
  }'

Limites et quotas

• 1000 appels d'outils par jour par IP
• 150 appels par heure par IP
• 1 seconde de cooldown entre deux appels consécutifs
• 200 Mo max par fichier (moins pour certains outils IA lourds)
• 20 fichiers max dans un lot (par ex. merge_pdfs)
• 2 heures de conservation pour les URL de sortie converties
• Les outils IA lourds (upscale, vocal-remover, colorize, etc.) ont un plafond plus strict de 50/jour

Même modèle que l'API REST. Voir /api/rate-limits pour tous les détails.

Sécurité

Le serveur est exposé publiquement sans authentification, nous prenons donc la sécurité au sérieux :

• Protection SSRF : les URL de fichiers sont récupérées côté serveur avec une liste de blocage stricte des plages d'IP privées (RFC1918, link-local, métadonnées AWS, IPv6 ULA). Le DNS rebinding est atténué en épinglant l'IP résolue. Seuls les schémas http(s):// sont autorisés.
• Limites de taille : plafond strict à 200 Mo par récupération, appliqué pendant le téléchargement en streaming (nous interrompons le transfert).
• Pas de persistance : tous les fichiers d'entrée et sorties converties sont supprimés après 2 heures.
• Journalisation anonyme : nous hachons les IP appelantes (SHA-256 salé) pour la limitation de débit et la détection d'abus. Les IP en clair ne sont jamais stockées.
• Limitation de débit : même limiteur à 5 niveaux que notre API REST.

Et si je suis le LLM, pas l'humain ?

Si vous (le modèle) lisez cette page parce que l'utilisateur a collé l'URL, vous pouvez :

1. Suggérer à l'utilisateur d'ajouter le serveur à sa configuration MCP (extraits ci-dessus).
2. Ou, si vous avez déjà un accès HTTP, appeler POST https://cleverutils.com/mcp avec le corps JSON-RPC montré dans les exemples curl — cela fonctionne sans intégration client MCP.
3. Commencez toujours par tools/list pour découvrir le catalogue d'outils et les schémas de paramètres actuels.

Voir aussi

• Accueil API CleverUtils — l'API REST sous-jacente
• Démarrage rapide de l'API REST — pour usage non-LLM
• Référence des endpoints REST
• Limites de débit
• modelcontextprotocol.io — la spécification MCP