Distill

Ein Claude Code MCP-Server, der gespeicherte Artikel in KI-generierte Podcasts verwandelt, die auf Ihre Interessen zugeschnitten sind.

Speichern Sie den ganzen Tag über Artikel. Generieren Sie auf Abruf einen Konversations-Podcast mit zwei Moderatoren. Die MP3-Datei landet in ~/Downloads, ein Ton wird abgespielt, die Warteschlange wird geleert. Alles läuft lokal.

Installation

git clone <this repo> ~/code/distill
cd ~/code/distill
npm install

Bei Claude Code registrieren

Fügen Sie Distill als MCP-Server hinzu. Der einfachste Weg — aus dem Verzeichnis, in dem Sie Ihre Warteschlange (Ihr „Lese-Projekt“) aufbewahren möchten:

claude mcp add distill -- node /absolute/path/to/distill/index.js

Oder fügen Sie es manuell zu Ihrer ~/.claude.json / Projekt-.mcp.json hinzu:

{
  "mcpServers": {
    "distill": {
      "command": "node",
      "args": ["/absolute/path/to/distill/index.js"]
    }
  }
}

Distill liest und schreibt Dateien im aktuellen Arbeitsverzeichnis, in dem Claude Code gestartet wurde, sodass Ihre Warteschlange und Transkripte neben dem Projekt liegen, an dem Sie gerade arbeiten. Wenn Sie eine einzige globale Warteschlange wünschen, setzen Sie DISTILL_PROJECT_ROOT:

{
  "mcpServers": {
    "distill": {
      "command": "node",
      "args": ["/absolute/path/to/distill/index.js"],
      "env": { "DISTILL_PROJECT_ROOT": "/Users/you/distill-home" }
    }
  }
}

Starten Sie Claude Code neu. Bestätigen Sie mit /mcp — Sie sollten sehen, dass distill verbunden ist.

Konfiguration

Einfacher Modus: Führen Sie /distill:setup innerhalb von Claude Code aus. Es führt Sie Schritt für Schritt durch die Fragen zu Interessen, Show-Stil, TTS-Anbieter und API-Schlüssel.

Manueller Modus: Beim ersten Start schreibt Distill eine Standard-.distill-Datei in das Projektstammverzeichnis. Bearbeiten Sie diese direkt:

INTERESTS=entrepreneurship, cybersecurity, AI, startups
SHOW_STYLE=The Briefing
TTS_PROVIDER=openai
OPENAI_API_KEY=sk-...
OUTPUT_DIR=~/Downloads

Siehe .distill.example für ein vollständig kommentiertes Beispiel.

Hinweis zum Dateisystem-Layout

Die Spezifikation beschreibt .distill sowohl als Datei als auch als Verzeichnis. Da dies nicht möglich ist, verwendet Distill:

• .distill — Konfigurationsdatei (dotenv-Format)

• .distill-data/ — Datenverzeichnis (queue.json, transcripts/)

Slash-Befehle

Claude Code stellt MCP-Prompts mit dem Präfix /mcp__<server>__<prompt> bereit, daher beginnen alle Distill-Befehle mit /mcp__distill__:

Tipp: Sie können normalerweise die ersten paar Buchstaben eingeben (z. B. /distill-pod) und die Autovervollständigung den Rest erledigen lassen.

Alle Befehle funktionieren auch als natürliche Sprache:

"Speichere das in meiner Podcast-Warteschlange: https://…" "Erstelle ein Deep Dive aus meiner Warteschlange" "Überspringe meine üblichen Interessen, konzentriere dich auf den technischen Aspekt"

Show-Stile

Pro Sitzung überschreibbar: "Mach es im Debate-Stil".

TTS-Anbieter

Funktionsweise

• Artikelabruf: @mozilla/readability + jsdom — entfernt Navigation/Anzeigen/Fußzeilen und liefert sauberen Text.

• Skriptgenerierung: Der MCP-Prompt weist das LLM von Claude Code an, die Warteschlange zu lesen, den Show-Stil zu laden und das Dialogskript inline zu schreiben. Kein separater Claude-API-Schlüssel erforderlich.

• TTS: Synthese pro Beitrag (ein API-Aufruf pro Dialogschritt, sodass jeder Moderator seine eigene Stimme erhält), dann zu einer einzigen MP3-Datei zusammengefügt.

• Transkript: Klartextkopie, die zur Fehlerbehebung in .distill-data/transcripts/ gespeichert wird.

• Benachrichtigung: macOS afplay spielt einen kurzen Systemton ab, wenn die MP3-Datei fertig ist.

Architektur & Kosten

Distill ist ein lokaler, stdio-basierter MCP-Server. Alles läuft auf dem Rechner des Benutzers. Es gibt kein gehostetes Backend.

 ┌───────────────┐   stdio    ┌───────────────┐    HTTPS     ┌──────────┐
 │ Claude Code   │◀──────────▶│ distill MCP   │────────────▶│ TTS API  │
 │ (your LLM)    │            │ (node process)│              │ (yours)  │
 └───────────────┘            └───────────────┘              └──────────┘
        │                            │
        │                            ▼
        │                   .distill  / .distill-data/
        ▼
  writes script,
  calls tools

Wer zahlt wofür:

Das bedeutet, jeder, der Distill forkt oder installiert, klont einfach das Repo und verweist Claude Code darauf. Kein Konto, keine Anmeldung, nichts zu deployen.

Umfang

• Nur Claude Code — kein eigenständiges CLI

• Nur Englisch

• macOS für Systemtöne vorausgesetzt

• Keine Unterstützung für JS-gerenderte oder hinter einer Paywall liegende Artikel

• Keine Zeitplanung — Generierung auf Abruf

Fehlerbehebung

• /mcp zeigt distill als fehlgeschlagen an — überprüfen Sie den absoluten Pfad zu index.js in Ihrer MCP-Konfiguration und stellen Sie sicher, dass npm install im Distill-Verzeichnis ausgeführt wurde.

• "Could not extract readable content" — die Seite liegt wahrscheinlich hinter einer Paywall oder ist JS-gerendert. Kein erneuter Versuch in v1.

• TTS schlägt mit "missing API key" fehl — kommentieren Sie genau eine TTS_PROVIDER=-Zeile in .distill aus und stellen Sie sicher, dass der passende *_API_KEY gesetzt ist.

• system TTS schlägt mit "requires ffmpeg or sox" fehl — brew install ffmpeg.