dropbox-transcripts-mcp

Dropboxに保存されたプレーンテキストのポッドキャスト文字起こしをインデックス化し、Claude Code内で検索可能にするMCPサーバーです。新しい文字起こしが追加されると自動的に同期されます。

機能

• Dropboxフォルダ内のすべての .txt 文字起こしをローカルのSQLiteデータベースにキャッシュし、全文検索（FTS5）を可能にします

• N時間ごとにDropboxをポーリングし、新規または変更されたファイルを自動的にインデックス化します

• Claude Codeに対して、リスト表示、取得、検索、手動同期の4つのツールを提供します

Related MCP server: transcript-search

前提条件

• Python 3.10以上

• uv (macOSの場合は brew install uv)

• 文字起こしファイルを保存している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. Settingsタブから App Key と App Secret をコピーします

2. 認証設定の実行

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

これによりOAuthフローが実行され、DROPBOX_REFRESH_TOKEN が表示されます。また、Claude Codeの設定に貼り付けるためのMCP設定ブロックも表示されます。

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