dropbox-transcripts-mcp

Un servidor MCP que indexa transcripciones de podcasts en texto plano almacenadas en Dropbox y las hace buscables dentro de Claude Code. Se sincroniza automáticamente a medida que se añaden nuevas transcripciones.

Qué hace

• Almacena en caché todas las transcripciones .txt de una carpeta de Dropbox en una base de datos SQLite local con búsqueda de texto completo (FTS5)

• Consulta Dropbox cada N horas e indexa archivos nuevos o modificados automáticamente

• Expone cuatro herramientas a Claude Code: listar, recuperar, buscar y sincronización manual

Related MCP server: transcript-search

Requisitos previos

• Python 3.10+

• uv (brew install uv en macOS)

• Una cuenta de Dropbox con tus transcripciones en una carpeta (predeterminado: /Podcasts/Lenny)

Configuración

1. Crear una aplicación de Dropbox

1. Ve a https://www.dropbox.com/developers/apps

2. Haz clic en Create app

3. Elige Scoped access y Full Dropbox

4. Ponle cualquier nombre (p. ej., transcripts-mcp)

5. En la pestaña Permissions, habilita:

   • files.metadata.read

   • files.content.read

6. Copia el App Key y el App Secret de la pestaña Settings

2. Ejecutar la configuración de autenticación

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

Esto te guiará a través del flujo OAuth e imprimirá tu DROPBOX_REFRESH_TOKEN. También imprimirá el bloque de configuración MCP exacto para pegar en tus ajustes de Claude Code.

3. Añadir a Claude Code

Edita ~/.claude/settings.json y añade:

{
  "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"
      }
    }
  }
}

La primera vez que Claude Code inicie el servidor, sincronizará todas las transcripciones desde Dropbox. Las sincronizaciones posteriores ocurren automáticamente en segundo plano cada 6 horas (configurable).

Configuración

Toda la configuración se realiza mediante variables de entorno:

Convención de nombres de archivo

Los archivos de transcripción deben llamarse Nombre del invitado.txt. El nombre del archivo (sin .txt) se convierte en el identificador del episodio utilizado por get_episode y mostrado en list_episodes.

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

Herramientas disponibles

Licencia

MIT