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)

• 대본이 저장된 폴더(기본값: /Podcasts/Lenny)가 있는 Dropbox 계정

설정

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