dropbox-transcripts-mcp

Ein MCP-Server, der in Dropbox gespeicherte Podcast-Transkripte im Klartext indiziert und sie innerhalb von Claude Code durchsuchbar macht. Synchronisiert automatisch, wenn neue Transkripte hinzugefügt werden.

Was er tut

• Cacht alle .txt-Transkripte aus einem Dropbox-Ordner in einer lokalen SQLite-Datenbank mit Volltextsuche (FTS5)

• Fragt Dropbox alle N Stunden ab und indiziert neue oder geänderte Dateien automatisch

• Stellt Claude Code vier Tools zur Verfügung: auflisten, abrufen, suchen und manuelle Synchronisierung

Related MCP server: transcript-search

Voraussetzungen

• Python 3.10+

• uv (brew install uv unter macOS)

• Ein Dropbox-Konto mit Ihren Transkripten in einem Ordner (Standard: /Podcasts/Lenny)

Einrichtung

1. Erstellen Sie eine Dropbox-App

1. Gehen Sie zu https://www.dropbox.com/developers/apps

2. Klicken Sie auf Create app

3. Wählen Sie Scoped access und Full Dropbox

4. Geben Sie ihr einen beliebigen Namen (z. B. transcripts-mcp)

5. Aktivieren Sie unter dem Tab Permissions:

   • files.metadata.read

   • files.content.read

6. Kopieren Sie den App Key und das App Secret aus dem Tab „Settings“

2. Führen Sie die Authentifizierungseinrichtung durch

uvx --from git+https://github.com/YOUR_USERNAME/dropbox-transcripts-mcp dropbox-transcripts-setup

Dies führt Sie durch den OAuth-Prozess und gibt Ihren DROPBOX_REFRESH_TOKEN aus. Es wird auch der exakte MCP-Konfigurationsblock ausgegeben, den Sie in Ihre Claude Code-Einstellungen einfügen können.

3. Zu Claude Code hinzufügen

Bearbeiten Sie ~/.claude/settings.json und fügen Sie Folgendes hinzu:

{
  "mcpServers": {
    "transcripts": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/YOUR_USERNAME/dropbox-transcripts-mcp",
        "dropbox-transcripts-mcp"
      ],
      "env": {
        "DROPBOX_APP_KEY": "your_app_key",
        "DROPBOX_APP_SECRET": "your_app_secret",
        "DROPBOX_REFRESH_TOKEN": "your_refresh_token",
        "DROPBOX_FOLDER_PATH": "/Podcasts/Lenny"
      }
    }
  }
}

Wenn Claude Code den Server zum ersten Mal startet, werden alle Transkripte aus Dropbox synchronisiert. Nachfolgende Synchronisierungen erfolgen automatisch im Hintergrund alle 6 Stunden (konfigurierbar).

Konfiguration

Die gesamte Konfiguration erfolgt über Umgebungsvariablen:

Dateibenennungskonvention

Transkriptdateien sollten Gastname.txt heißen. Der Dateiname (ohne .txt) wird zum Episodenbezeichner, der von get_episode verwendet und in list_episodes angezeigt wird.

Beispiele: Adam Fishman.txt, Elena Verna 2.0.txt

Verfügbare Tools

Lizenz

MIT