OpenClip: Miniaturansichten und Bildbearbeitung

Was macht OpenClip: Miniaturansichten und Bildbearbeitung?

Zwei kostenlose Tools, die meist zusammen verwendet werden:

• extract_thumbnails – Standbilder aus einem Video extrahieren.
• edit_image – Bild komprimieren, skalieren, zuschneiden oder formatieren.

Beide sind KOSTENLOS, sie benötigen ein OpenClip-Konto, aber kein Abonnement und keine Credits.

Einrichtung (einmalig)

OpenClip ist ein entfernter MCP-Server unter https://openclip.app/mcp. Melde dich mit deinem OpenClip-Konto an, wenn der OAuth-Hinweis erscheint. Es gibt keinen API-Schlüssel zum Kopieren.

• Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp, dann /mcp zur Autorisierung.
• Claude Desktop / Web: Einstellungen, Connectors, „Benutzerdefinierten Connector hinzufügen”, URL einfügen, anmelden.
• Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Nur-Header-Clients: Generiere ein MCP-Token unter openclip.app/settings/connect und verbinde dich mit https://openclip.app/mcp/key mit Authorization: Bearer <token>.

Testaufruf: get_account aufrufen.

Datei hereinbekommen

1. create_upload(filename, content_type) gibt eine id und eine upload_url zurück.
2. Sende die rohen Bytes per PUT an upload_url.
3. Übergib die zurückgegebene id als video (für Miniaturen) oder file (für Bildbearbeitung).

Rufe NICHT complete_upload auf. Das startet die kostenpflichtige Clipping-Pipeline. Die kostenlosen Tools lesen die hochgeladene Datei direkt. Videos, die bereits in list_videos vorhanden sind, können ebenfalls als Eingabe verwendet werden.

extract_thumbnails

extract_thumbnails(video, count?, width?).

• count – 1 bis 10, Standard 1. Die Bilder werden gleichmäßig über das Video verteilt, sodass count: 5 eine grobe Kontaktseite zur Auswahl ergibt.
• width – optionale Pixelbreite für die Ausgabebilder.

Die Ausgabe ist ein Zip-Archiv von Bildern, keine einzelnen Bild-URLs. Gib dem Benutzer die Zip-URL oder entpacke sie, wenn ein bestimmtes Bild benötigt wird.

Wenn der Benutzer ein Bild zu einem exakten Zeitpunkt und nicht gleichmäßig verteilt haben möchte, schneide das Video zuerst mit edit_video (operation="trim", siehe openclip-video-editing) auf diesen Moment zu und extrahiere dann eine Miniaturansicht aus dem zugeschnittenen Clip.

edit_image

edit_image(file, operation, ...params), ein Vorgang pro Aufruf:

• compress – quality 1 bis 100 (Standard 80), optional format (jpg, png, webp).
• resize – width und height in Pixeln, optional format.
• crop – entweder aspect ("1:1", "9:16", "16:9", "4:5") oder explizite x, y, width, height, optional format.

Verwende webp, wenn das Bild auf einer Webseite erscheint, und jpg, wenn es überall funktionieren muss.

Abfragen

Beide Tools geben eine tool_job-Hash-ID mit status: "queued" zurück. Frage alle 5 bis 10 Sekunden get_tool_job_status(tool_job) ab:

• queued / processing – noch in Bearbeitung, weiter abfragen.
• completed – liefert dauerhafte CDN-outputs-URLs sowie result_meta.
• failed – liefert error.

Regeln

• Immer abfragen, beide Tools sind asynchron.
• Ein edit_image-Vorgang pro Aufruf. Um zu skalieren und dann zu komprimieren, führe zwei Aufrufe nacheinander aus.
• extract_thumbnails gibt immer ein Zip-Archiv zurück. Versprich dem Benutzer keine einzelnen Bild-URLs.
• Ausgabe-URLs sind dauerhafte CDN-Links, nicht signiert oder mit Ablaufdatum.
• Die kostenlose Nutzung ist pro Tag ratenbegrenzt und hat eine Dateigrößen-Obergrenze.

Beispielaufforderungen zu Aktionen

• „Hole eine Miniaturansicht aus diesem Video” – create_upload, PUT-Bytes, extract_thumbnails(video), abfragen, Zip-URL zurückgeben.
• „Gib mir 5 Bilder zur Auswahl” – extract_thumbnails(video, count=5), abfragen.
• „Ich möchte das Bild bei 1:30” – edit_video(video, operation="trim", start_ms=90000, end_ms=91000), abfragen, dann extract_thumbnails auf diese Ausgabe, abfragen.
• „Mache dieses Bild zu einem quadratischen WebP” – edit_image(file, operation="crop", aspect="1:1", format="webp"), abfragen.
• „Dieses PNG ist riesig, verkleinere es” – edit_image(file, operation="compress", quality=75, format="webp"), abfragen.

Verwandte Tools

Das Ausschneiden des Motivs in ein transparentes PNG ist openclip-remove-background. Videotrimmen und -zuschneiden ist openclip-video-editing.