🎬 MCP-gestütztes Video-RAG

Stellen Sie natürliche Sprachfragen zu Ihren Videos — unterstützt von Whisper + ChromaDB + Groq + FastMCP. Vollständig kostenlos und läuft lokal.

Architektur & Funktionsweise

Your Video → Whisper (transcription) → ChromaDB (vector store)
                                              ↓
                              Antigravity IDE ← MCP Server ← Your Question
                                              ↓
                                         Groq LLM (free) → Answer + Timestamps

Stack (Alles kostenlos)

⚡ Schnellstart

1. Abhängigkeiten installieren

uv sync

2. Holen Sie sich Ihren KOSTENLOSEN Groq-API-Schlüssel

Gehen Sie zu https://console.groq.com/ → Konto erstellen → API-Schlüssel kopieren.

3. Umgebung einrichten

copy .env.example .env
# Edit .env and paste your GROQ_API_KEY

4. Fügen Sie den MCP-Server zu Antigravity IDE hinzu

Kopieren Sie den Inhalt von mcp_config.json in Ihre Antigravity-IDE-MCP-Einstellungen. Aktualisieren Sie GROQ_API_KEY mit Ihrem tatsächlichen Schlüssel.

5. Legen Sie Videos im Ordner videos/ ab

Unterstützt: .mp4, .mkv, .avi, .mov, .webm, .mp3, .wav

🛠️ Verfügbare MCP-Tools

📖 Beispielverwendung (in Antigravity IDE)

ingest_video("videos/my_lecture.mp4")

ask_video("What are the main topics discussed?")

search_video("neural networks explained", n_results=3)

ask_video("What did the speaker say about backpropagation?", video_name="my_lecture.mp4")

⚙️ Konfiguration (.env)

GROQ_API_KEY=your_key_here        # Required — get free at console.groq.com
WHISPER_MODEL=base                # tiny | base | small | medium | large
EMBEDDING_MODEL=all-MiniLM-L6-v2  # local embedding model
GROQ_MODEL=llama-3.1-8b-instant  # Groq model for Q&A
CHROMA_DB_PATH=./chroma_db        # where to persist the vector DB

💡 Tipps

• Verwenden Sie WHISPER_MODEL=tiny für die schnellste Transkription (weniger genau)

• Verwenden Sie WHISPER_MODEL=medium für hohe Genauigkeit (langsamer)

• Beim ersten Lauf werden Whisper- und Einbettungsmodelle heruntergeladen (jeweils ~200 MB) – spätere Läufe sind sofort einsatzbereit

• ChromaDB-Daten bleiben über Neustarts hinweg in ./chroma_db/ erhalten