Communitygithub.com

ffmpeg-mcp-server

FFmpeg MCP Server mit Windows-Pfadkompatibilität – Video-/Bildverarbeitung für Cursor AI

Was ist ffmpeg-mcp-server?

Der ffmpeg-mcp-server ist ein MCP-Server (Model Context Protocol), der die leistungsstarke FFmpeg-Bibliothek für Video- und Bildverarbeitungsaufgaben über KI-Assistenten wie Cursor AI zugänglich macht. Entwickler können damit direkt aus der KI-Entwicklungsumgebung heraus Operationen wie Konvertierung, Zuschneiden, Größenänderung, Filterung und Metadaten-Extraktion von Mediendateien durchführen – ohne manuelle Befehlszeilenaufrufe. Besonders hervorzuheben ist die umfassende Windows-Kompatibilität, die sicherstellt, dass Dateipfade korrekt verarbeitet werden und ffmpeg unter Windows zuverlässig funktioniert. Der Server verarbeitet Werkzeuge wie `convert_video`, `extract_audio`, `resize_image` und viele weitere, und gibt strukturierte Ergebnisse mit Pfaden zu den Ausgabedateien zurück. Dies macht ihn ideal für Workflows, die in KI-gestützten Coding-Umgebungen wie Cursor, Claude Code oder Codex automatisierte Medienbearbeitung erfordern.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add 2799662352/ffmpeg-mcp-server

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht ffmpeg-mcp-server?

FFmpeg MCP Server mit Windows-Pfadkompatibilität – Video-/Bildverarbeitung für Cursor AI

Übersicht

Dieser MCP-Server (Model Context Protocol) integriert die FFmpeg-Bibliothek in KI-Assistenten wie Cursor AI, sodass Sie Video- und Bildverarbeitungsaufgaben über natürliche Sprachbefehle ausführen können.

Funktionen

  • Videokonvertierung: Konvertieren Sie Videos zwischen verschiedenen Formaten (z. B. MP4, AVI, MOV, MKV)
  • Bildverarbeitung: Ändern Sie die Größe, beschneiden Sie Bilder oder wenden Sie Filter an
  • Audiomanipulation: Extrahieren oder entfernen Sie Audiospuren aus Videos
  • Metadaten-Extraktion: Rufen Sie Mediendatei-Metadaten wie Codec, Bitrate, Auflösung usw. ab
  • Windows-Pfadkompatibilität: Korrekte Handhabung von Windows-Dateipfaden (z. B. C:\Users\...)

Voraussetzungen

  • ffmpeg installiert und im System-PATH verfügbar
    • Windows: Laden Sie von ffmpeg.org herunter und fügen Sie es zum PATH hinzu
    • macOS: brew install ffmpeg
    • Linux: sudo apt install ffmpeg (oder entsprechend)
  • Node.js Version 18 oder höher
  • Cursor AI (oder ein beliebiger MCP-kompatibler Client)

Installation

  1. Klonen Sie das Repository:

    git clone https://github.com/2799662352/ffmpeg-mcp-server.git
    cd ffmpeg-mcp-server
    
  2. Installieren Sie Abhängigkeiten:

    npm install
    
  3. Bauen Sie das Projekt:

    npm run build
    
  4. Konfigurieren Sie Cursor AI zur Verwendung des Servers.

Verwendung

Sobald der Server läuft, können Sie in Cursor AI Befehle wie die folgenden verwenden:

Videokonvertierung

"Konvertiere dieses Video von MP4 zu AVI"
"Ändere die Größe dieses Videos auf 1920x1080"

Bildverarbeitung

"Ändere die Größe dieses Bildes auf 800x600"
"Beschneide dieses Bild auf 400x400 von der Mitte aus"

Audio extrahieren

"Extrahiere den Ton aus diesem Video als MP3"

Metadaten abrufen

"Zeig mir die Metadaten dieser Videodatei"

Verfügbare Werkzeuge

WerkzeugBeschreibung
convert_videoVideo von einem Format in ein anderes konvertieren
resize_videoVideogröße auf bestimmte Abmessungen ändern
extract_audioAudiospur aus Video extrahieren
remove_audioAudiospur aus Video entfernen
resize_imageBildgröße ändern
crop_imageBild zuschneiden
get_media_infoMediendatei-Metadaten abrufen

Technische Details

  • Programmiersprache: TypeScript
  • Laufzeitumgebung: Node.js
  • Protokoll: Model Context Protocol (MCP)
  • Abhängigkeiten: ffmpeg-CLI, @modelcontextprotocol/sdk

Lizenz

MIT

Beitrag leisten

Beiträge sind willkommen! Bitte öffnen Sie Issues oder Pull Requests.

Verwandte Skills