CleverUtils MCP-Server

Server-Endpunkt

Der MCP-Server spricht JSON-RPC 2.0 über HTTP unter:

https://cleverutils.com/mcp

Er implementiert den Streamable-HTTP-Transport (POST für JSON-RPC-Anfragen). Kein Sitzungsstatus, keine Authentifizierung, IP-ratenbegrenzt auf 1000 Anfragen pro Tag.

Von Claude Desktop verbinden

{
  "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"
    }
  }
}

Verfügbare Tools

Der Server stellt 15 Tools bereit. Alle Tool-Eingaben akzeptieren entweder eine HTTPS-URL (der Server holt sie mit SSRF-Schutz) oder eine base64-kodierte Datei. Ausgaben werden als MCP-resource_link-Blöcke zurückgegeben, die auf eine 2 Stunden gültige Download-URL zeigen.

Beispiel-Prompts

Einmal verbunden, können Sie den LLM nach Dingen wie diesen fragen:

• „Konvertiere https://example.com/photo.heic zu JPG."
• „Vergrößere dieses Bild 4x: https://example.com/icon.png"
• „Entferne den Hintergrund von https://example.com/portrait.jpg und gib mir das transparente PNG."
• „Transkribiere diesen Podcast als SRT-Untertitel auf Englisch: https://example.com/episode.mp3"
• „Komprimiere diese PDF auf etwa 50% der ursprünglichen Größe: https://example.com/report.pdf"
• „Führe diese drei PDFs zu einer zusammen: https://…/a.pdf, https://…/b.pdf, https://…/c.pdf"

Wie es funktioniert

1. LLM wählt ein Tool. Basierend auf Ihrer Anfrage betrachtet der LLM die Tool-Liste und wählt eines aus (z. B. upscale_image) mit den richtigen Argumenten.
2. Server holt die Datei. Wenn Sie eine URL übergeben haben, lädt der Server sie serverseitig herunter — hinter einer strengen SSRF-Sperrliste (keine privaten IPs, kein file://, kein DNS-Rebinding).
3. Konvertierung läuft. Dieselbe Engine wie unsere Website und REST-API: ImageMagick, FFmpeg, Real-ESRGAN, Demucs, Whisper, Ghostscript, LibreOffice.
4. Ergebnis wird als Ressourcenlink zurückgegeben. Der LLM erhält eine strukturierte Antwort, die sowohl menschenlesbaren Text („Datei konvertiert: photo.jpg, 180 KB") als auch einen maschinenlesbaren resource_link mit einer 2 Stunden gültigen Download-URL enthält.

Testen Sie es vom Terminal aus

Wenn Sie nur prüfen wollen, ob der Server funktioniert, ohne einen vollständigen MCP-Client einzurichten, versuchen Sie dieses 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"
      }
    }
  }'

Limits und Kontingente

• 1000 Tool-Aufrufe pro Tag pro IP
• 150 Aufrufe pro Stunde pro IP
• 1 Sekunde Cooldown zwischen aufeinanderfolgenden Aufrufen
• Max. 200 MB pro Datei (weniger für einige rechenintensive KI-Tools)
• Max. 20 Dateien in einem Batch (z. B. merge_pdfs)
• 2 Stunden Aufbewahrung für konvertierte Ausgabe-URLs
• Rechenintensive KI-Tools (upscale, vocal-remover, colorize usw.) haben eine strengere Grenze von 50/Tag

Gleiches Modell wie die REST-API. Siehe /api/rate-limits für alle Details.

Sicherheit

Der Server ist öffentlich ohne Authentifizierung verfügbar, daher nehmen wir Sicherheit ernst:

• SSRF-Schutz: Datei-URLs werden serverseitig mit einer strengen Sperrliste privater IP-Bereiche (RFC1918, Link-Local, AWS-Metadaten, IPv6 ULA) geholt. DNS-Rebinding wird durch Fixieren der aufgelösten IP abgemildert. Nur http(s)://-Schemata sind erlaubt.
• Größenlimits: harte Obergrenze von 200 MB pro Abruf, während des Streaming-Downloads durchgesetzt (wir brechen mitten im Transfer ab).
• Keine Persistenz: alle Eingabedateien und konvertierten Ausgaben werden nach 2 Stunden gelöscht.
• Anonyme Protokollierung: wir hashen Aufrufer-IPs (gesalzener SHA-256) zur Ratenbegrenzung und Missbrauchserkennung. Klartext-IPs werden nie gespeichert.
• Ratenbegrenzung: identischer 5-stufiger Limiter wie unsere REST-API.

Was, wenn ich der LLM bin, nicht der Mensch?

Wenn Sie (das Modell) diese Seite lesen, weil der Benutzer die URL eingefügt hat, können Sie:

1. Dem Benutzer vorschlagen, den Server zu seiner MCP-Konfiguration hinzuzufügen (Snippets oben).
2. Oder, falls Sie bereits HTTP-Zugriff haben, POST https://cleverutils.com/mcp mit dem in den curl-Beispielen gezeigten JSON-RPC-Body aufrufen — das funktioniert ohne MCP-Client-Integration.
3. Beginnen Sie immer mit tools/list, um den aktuellen Tool-Katalog und die Parameter-Schemas zu entdecken.

Siehe auch

• CleverUtils API-Startseite — die zugrunde liegende REST-API
• REST API-Schnellstart — für Nicht-LLM-Nutzung
• REST-Endpunkt-Referenz
• Ratenlimits
• modelcontextprotocol.io — die MCP-Spezifikation