dropbox-automation

Dropbox Automation via Rube MCP 是一个通过 Composio 的 Dropbox 工具包自动化 Dropbox 各项操作的技能，涵盖文件上传/下载、搜索、文件夹管理、分享链接、批量操作与元数据获取。

【用途】 用于让 AI 客户端（如支持 MCP 的工具）连接 Rube MCP 后，以工具调用的方式操作 Dropbox 账号中的文件与文件夹。

【前置条件】

1. 必须已连接 Rube MCP（具备 RUBE_SEARCH_TOOLS 可用）。
2. 必须通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Dropbox 连接（toolkit 为 dropbox）。
3. 每次操作前先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

【设置方式】

1. 在客户端配置中把 https://rube.app/mcp 添加为 MCP 服务器。无需 API 密钥，添加端点即可工作。
2. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
3. 调用 RUBE_MANAGE_CONNECTIONS（toolkit dropbox）。
4. 若连接不是 ACTIVE，按返回的授权链接完成 Dropbox OAuth。
5. 确认连接状态为 ACTIVE 后再执行任何工作流。

【主要能力与核心工作流】

1. 搜索文件与文件夹：使用 DROPBOX_SEARCH_FILE_OR_FOLDER 按查询字符串检索，支持路径范围、文件类别、扩展名、仅匹配文件名、每页结果数等参数；有更多结果时用 DROPBOX_SEARCH_CONTINUE 按游标翻页；可用 DROPBOX_GET_METADATA 校验并获取规范路径，用 DROPBOX_READ_FILE 读取内容确认。注意：搜索与续查合计最多 10000 个匹配；返回的 path_display 大小写可能与输入不同，应使用 API 返回的规范路径；文件内容可能为 base64 编码的 file_content_bytes，解析前需解码。
2. 上传与下载：DROPBOX_UPLOAD_FILE 上传（mode 为 add 默认冲突失败或 overwrite，autorename 冲突自动重命名）；DROPBOX_READ_FILE 下载/读取；DROPBOX_DOWNLOAD_ZIP 下载整个文件夹为 zip；DROPBOX_SAVE_URL 从公开 URL 保存文件到 Dropbox；DROPBOX_GET_SHARED_LINK_FILE 从分享链接下载；DROPBOX_EXPORT_FILE 导出 Dropbox Paper 等不可下载文件为 markdown/HTML/纯文本。注意：SAVE_URL 是异步的，大文件可能需最长 15 分钟；DOWNLOAD_ZIP 要求文件夹小于 20GB、单文件不超过 4GB、条目少于 10000。
3. 分享文件与管理链接：先 DROPBOX_GET_METADATA 确认存在并获取规范路径，DROPBOX_LIST_SHARED_LINKS 检查已有链接，再 DROPBOX_CREATE_SHARED_LINK 创建；可用 DROPBOX_GET_SHARED_LINK_METADATA 解析链接、DROPBOX_LIST_SHARED_FOLDERS 列出共享文件夹。设置支持 audience、access、expires、密码与下载权限。注意：已存在链接时创建会返回 409 Conflict，应先查再建；requested_visibility 已弃用，新实现用 audience。
4. 文件夹管理：DROPBOX_CREATE_FOLDER 与 DROPBOX_CREATE_FOLDER_BATCH 创建；DROPBOX_MOVE_FILE_OR_FOLDER、DROPBOX_MOVE_BATCH 移动或重命名；DROPBOX_DELETE_FILE_OR_FOLDER、DROPBOX_DELETE_BATCH 删除；DROPBOX_COPY_FILE_OR_FOLDER 复制；批量任务用 DROPBOX_CHECK_MOVE_BATCH / DROPBOX_CHECK_FOLDER_BATCH 轮询状态。注意：路径区分大小写且必须以 / 开头，不能以 / 或空白结尾；批量操作可能异步；每批删除/移动最多 1000 条，批量创建文件夹最多 10000 个路径；批量移动不支持仅大小写改名；v2 的 MOVE_BATCH 优于 v1 的 FILES_MOVE_BATCH。
5. 列出文件夹内容：DROPBOX_LIST_FILES_IN_FOLDER 列出内容；DROPBOX_LIST_FOLDERS 为替代列目录方式并支持已删除条目；DROPBOX_GET_METADATA 获取单项详情。根目录用空字符串 "" 而非 "/"；递归列表可能很大，用 limit 控制分页。

【通用模式】 路径大多使用字符串（如 /Documents/file.pdf），部分工具支持 id: 格式；后续调用建议使用 DROPBOX_GET_METADATA 返回的 path_display 或 path_lower；游标分页用于搜索、列目录与分享链接；异步操作包括 SAVE_URL、MOVE_BATCH、CREATE_FOLDER_BATCH、DELETE_BATCH。

【限制与已知问题】 Dropbox API 各端点有速率限制，批处理可减少调用次数；搜索最多 10000 个匹配；SAVE_URL 大文件超时 15 分钟；不可下载文件需用 EXPORT_FILE；分享链接下载可能需要 link_password；共享文件夹访问可能不出现在标准路径列表中，需用 LIST_SHARED_FOLDERS。以上为资料明确提供的功能、参数与限制，其余收费、价格或平台信息暂未提供。