dropbox-transcripts-mcp

一个 MCP 服务器，用于索引存储在 Dropbox 中的纯文本播客转录稿，并使其能够在 Claude Code 中进行搜索。当添加新的转录稿时会自动同步。

功能

• 将 Dropbox 文件夹中的所有 .txt 转录稿缓存到本地 SQLite 数据库中，并支持全文搜索 (FTS5)

• 每隔 N 小时轮询一次 Dropbox，并自动索引新增或更改的文件

• 为 Claude Code 提供四个工具：列出、检索、搜索和手动同步

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 小时（可配置）自动进行一次。

配置

所有配置均通过环境变量进行：

文件命名规范

转录稿文件应命名为 Guest Name.txt。文件名（不含 .txt）将成为 get_episode 使用的剧集标识符，并显示在 list_episodes 中。

示例：Adam Fishman.txt, Elena Verna 2.0.txt

可用工具

许可证

MIT