name: Uploadcare自动化 description: “通过自然语言命令自动化Uploadcare文件管理，包括列表、存储、检查、下载和组织文件组” requires: mcp: - rube
Uploadcare自动化
自动化Uploadcare文件处理工作流程——通过自然语言列出项目文件、永久存储上传、检索文件元数据、获取下载URL和管理文件组。
工具包文档： composio.dev/toolkits/uploadcare
设置
- 将Rube MCP服务器添加到您的环境：
https://rube.app/mcp - 提示时连接您的Uploadcare账户（通过Composio进行API密钥身份验证）
- 开始为Uploadcare自动化发出自然语言命令
核心工作流程
1. 列出项目文件
浏览您Uploadcare项目中的上传文件，支持过滤、排序和分页。
工具： UPLOADCARE_LIST_FILES
关键参数：
stored—— 按存储状态过滤："true"表示已存储，"false"表示未存储removed—— 按删除状态过滤："true"表示已删除，"false"表示活跃ordering—— 按datetime_uploaded（升序）或-datetime_uploaded（降序）排序limit—— 每页文件数，1-1000（默认100）offset—— 基于零的分页偏移from_date—— ISO 8601时间戳，过滤在此日期之后上传的文件to_date—— ISO 8601时间戳，过滤在此日期之前上传的文件include—— 设置为"total"以在响应中包含总文件数
示例提示：
“列出我Uploadcare项目中50个最近上传的已存储文件”
2. 永久存储文件
将上传的文件标记为永久存储。默认情况下，Uploadcare文件是临时的，除非存储，否则将在24小时后删除。
工具： UPLOADCARE_STORE_FILE
关键参数：
uuid—— 要存储的文件的UUID（必需）；必须为8-4-4-4-12十六进制格式（例如，3e55317b-23d1-4f35-9b4c-b9accb7b53f4）
上传后始终存储文件以防止自动删除。
示例提示：
“永久存储UUID为3e55317b-23d1-4f35-9b4c-b9accb7b53f4的文件”
3. 获取文件元数据
检索特定文件的详细信息，包括大小、MIME类型、CDN URL、图像尺寸等。
工具： UPLOADCARE_GET_FILE_INFO
关键参数：
uuid—— 要检查的文件的UUID（必需）；格式：8-4-4-4-12十六进制
返回：文件名、大小、MIME类型、CDN URL、上传日期、存储状态、图像信息（尺寸、颜色模式）等。
示例提示：
“获取文件3e0923f2-e05a-4b37-9f0d-343b981c9d70的元数据和尺寸”
4. 获取临时下载URL
检索特定文件的临时直接下载链接。
工具： UPLOADCARE_GET_FILE_DOWNLOAD_URL
关键参数：
file_id—— 唯一文件标识符（必需）
返回一个时间限制的URL，可用于直接文件下载。
示例提示：
“获取文件3e0923f2-e05a-4b37-9f0d-343b981c9d70的下载链接”
5. 浏览文件组
列出您项目中的文件组。组是一起上传的文件集合。
工具： UPLOADCARE_LIST_GROUPS
关键参数：
limit—— 每页组数，1-1000（默认20）offset—— 基于零的分页偏移（默认0）ordering—— 按datetime_created（升序）或-datetime_created（降序）排序
示例提示：
“列出我10个最近的文件组”
6. 文件生命周期工作流程
结合工具进行端到端文件管理：
- 上传： 文件通过Uploadcare的上传API或小部件上传（在此工具包外部）
- 存储：
UPLOADCARE_STORE_FILE—— 将文件标记为永久以防止自动删除 - 检查：
UPLOADCARE_GET_FILE_INFO—— 验证元数据，检查尺寸和MIME类型 - 分享：
UPLOADCARE_GET_FILE_DOWNLOAD_URL—— 生成临时下载链接 - 浏览：
UPLOADCARE_LIST_FILES—— 使用状态和日期过滤器审核所有文件 - 组：
UPLOADCARE_LIST_GROUPS—— 审查批量上传
示例提示：
“存储文件abc-123，然后获取其元数据和下载链接”
已知陷阱
| 陷阱 | 详情 |
|---|---|
| 未存储文件的自动删除 | 上传的文件默认是临时的，24小时后删除——始终调用UPLOADCARE_STORE_FILE以持久化它们 |
| UUID格式严格 | 文件UUID必须为精确的8-4-4-4-12十六进制格式（例如，3e55317b-23d1-4f35-9b4c-b9accb7b53f4）；无效格式将被拒绝 |
| 过滤值是字符串 | stored和removed参数接受字符串值"true"或"false"，而不是布尔值 |
| 临时下载URL | 来自UPLOADCARE_GET_FILE_DOWNLOAD_URL的URL有时间限制，将过期 |
| 分页基于偏移 | 使用offset + limit进行分页；没有基于游标的分页令牌 |
| 没有上传工具 | 文件上传通过Uploadcare的上传API或小部件进行，不通过此工具包——这些工具管理已上传的文件 |
快速参考
| 操作 | 工具标识 | 关键参数 |
|---|---|---|
| 列出文件 | UPLOADCARE_LIST_FILES |
stored, ordering, limit, offset |
| 存储文件 | UPLOADCARE_STORE_FILE |
uuid |
| 获取文件信息 | UPLOADCARE_GET_FILE_INFO |
uuid |
| 获取下载URL | UPLOADCARE_GET_FILE_DOWNLOAD_URL |
file_id |
| 列出组 | UPLOADCARE_LIST_GROUPS |
limit, offset, ordering |
由Composio提供支持