dropbrowse

dropbrowse

AI クライアント向けに、Dropbox アカウントへの読み取り専用アクセスを提供します。フォルダーの閲覧、名前によるファイルの検索、ファイル内のテキスト検索、ファイル内容の読み取り、ファイルのメタデータの確認ができます。dropbrowse が Dropbox に書き込みを行うことはありません。

認証には、DROPBOX_ACCESS_TOKEN 環境変数に設定した Dropbox アクセストークンを使用します。Dropbox App Console で、アプリを作成する際に「Scoped access」と「Full Dropbox」を選び、files.metadata.read と files.content.read の権限を有効にしてから、アクセストークンを生成してください。この環境変数が設定されていない場合、リクエストを送信する前に、変数名を示すエラーですべてのコマンドが失敗します。

CLI

export DROPBOX_ACCESS_TOKEN=…

npx @reneturcios/dropbrowse list /documents --max-files 50
npx @reneturcios/dropbrowse search invoice --types pdf --max-results 5
npx @reneturcios/dropbrowse read /documents/notes.txt --max-length 0
npx @reneturcios/dropbrowse info /documents/report.pdf
npx @reneturcios/dropbrowse grep "important keyword" /documents/file1.txt /documents/file2.md
npx @reneturcios/dropbrowse --version

終了コード：成功時は 0、実行時エラー（トークンの未設定や上流での障害を含む）時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/dropbrowse mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "dropbrowse": {
      "command": "npx",
      "args": ["-y", "@reneturcios/dropbrowse", "mcp"],
      "env": { "DROPBOX_ACCESS_TOKEN": "your_access_token_here" }
    }
  }
}

ツール

• list_files — Dropbox ディレクトリ内のファイルとフォルダーを一覧表示します。 folder_path（省略可能。ルートの場合は空）、max_files（省略可能。デフォルトは 20）。
• search_files — 名前でファイルを検索します。query（必須）、 file_types（省略可能。「all」、「pdf」、「docx」、「txt」、または カンマ区切り）、max_results（省略可能。デフォルトは 10）。
• read_file — ファイルの内容全体を読み取ります。file_path （必須）、max_length（省略可能。デフォルトは 5000。0 の場合は 無制限）。
• get_file_info — ファイルの詳細なメタデータを取得します。 file_path（必須）。
• search_file_content — 指定したファイル内のテキストを検索します。 file_paths（必須のリスト）、query（必須）、 context_chars（省略可能。デフォルトは 100）。

テキスト抽出 — 対応範囲について

プレーンテキスト形式のファイル（TXT、MD、PY、JS、HTML、CSS、JSON、CSV、およびその他の UTF-8 テキスト）は、テキストとして読み取り・検索できます。PDF、DOC、DOCX ファイルの読み取りや内容の検索を行うと、このビルドではバイナリ形式からのテキスト抽出が実装されていないことを示すエラーが返されます。

Docker

docker run -i -e DROPBOX_ACCESS_TOKEN ghcr.io/cloudcorprecords/dropbrowse
docker run --rm -e DROPBOX_ACCESS_TOKEN ghcr.io/cloudcorprecords/dropbrowse list /documents

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios