dropbox-transcripts-mcp

MCP-сервер, который индексирует текстовые расшифровки подкастов, хранящиеся в Dropbox, и делает их доступными для поиска в Claude Code. Автоматическая синхронизация при добавлении новых расшифровок.

Что он делает

• Кэширует все расшифровки в формате .txt из папки Dropbox в локальную базу данных SQLite с полнотекстовым поиском (FTS5)

• Опрашивает Dropbox каждые N часов и автоматически индексирует новые или измененные файлы

• Предоставляет четыре инструмента для Claude Code: список, получение, поиск и ручная синхронизация

Related MCP server: transcript-search

Предварительные требования

• Python 3.10+

• uv (brew install uv в macOS)

• Учетная запись Dropbox с вашими расшифровками в папке (по умолчанию: /Podcasts/Lenny)

Настройка

1. Создайте приложение Dropbox

1. Перейдите на https://www.dropbox.com/developers/apps

2. Нажмите Create app

3. Выберите Scoped access и Full Dropbox

4. Назовите его как угодно (например, transcripts-mcp)

5. На вкладке Permissions включите:

   • files.metadata.read

   • files.content.read

6. Скопируйте App Key и App Secret на вкладке Settings

2. Запустите настройку аутентификации

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

Это проведет вас через процесс OAuth и выведет ваш DROPBOX_REFRESH_TOKEN. Также будет выведен готовый блок конфигурации MCP, который нужно вставить в настройки Claude Code.

3. Добавьте в Claude Code

Отредактируйте ~/.claude/settings.json и добавьте:

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

При первом запуске сервера Claude Code синхронизирует все расшифровки из Dropbox. Последующие синхронизации происходят автоматически в фоновом режиме каждые 6 часов (настраивается).

Конфигурация

Вся конфигурация осуществляется через переменные окружения:

Соглашение об именовании файлов

Файлы расшифровок должны называться Имя гостя.txt. Имя файла (без .txt) становится идентификатором эпизода, используемым в get_episode и отображаемым в list_episodes.

Примеры: Adam Fishman.txt, Elena Verna 2.0.txt

Доступные инструменты

Лицензия

MIT