dropbrowse

Name: dropbrowse
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords文件与存储01 周前更新

代码仓库

关于 dropbrowse

dropbrowse 是面向 AI 客户端的 Dropbox 只读 MCP 服务和命令行工具，可列出、搜索文件，读取支持的文本格式并查看元数据，不会修改 Dropbox。

主要功能

01列出 Dropbox 文件和文件夹
02按名称和类型搜索文件
03读取 UTF-8 文本文件
04搜索指定文件中的文本
05查看文件元数据

适用场景

01浏览 Dropbox 目录
02按名称或类型查找文件
03在指定文件中搜索文本
04处理文件前检查元数据

MCP 相关

向 MCP 客户端提供列出文件、按名称和内容搜索、读取文件及查看元数据的工具。尚未实现 PDF、DOC 和 DOCX 的文本提取。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-dropbrowse": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/dropbrowse"
      ]
    }
  }
}

启动命令npx -y @reneturcios/dropbrowse

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/dropbrowse0.1.0stdio

ocighcr.io/cloudcorprecords/dropbrowse:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
max_files	integer	否	返回的项目数上限（默认值：20）
folder_path	string	否	文件夹路径（根目录为空）

详细介绍

dropbrowse

为 AI 客户端提供对 Dropbox 帐户的只读访问权限：浏览文件夹、按名称查找文件、搜索文件中的文本、读取文件内容并查看文件元数据。dropbrowse 不会向 Dropbox 写入数据。

身份验证使用 Dropbox 访问令牌，并将其存储在 DROPBOX_ACCESS_TOKEN 环境变量中。在 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