文件上传

upload-mcp - COS文件上传工具

功能特性

基础功能

• ✅ 单文件上传: 支持将单个文件上传到腾讯云COS
• ✅ 图片文件特殊处理: 自动识别图片文件并提供图片相关功能
• ✅ 文件类型验证: 支持常见图片、文档、压缩包格式
• ✅ 自定义目标路径: 支持指定COS存储路径
• ✅ 自动路径生成: 如不指定路径，自动生成带时间戳的路径

分块上传功能

• 🚀 智能分块上传: 自动检测大文件并启用分块上传（>5MB）
• 💪 断点续传: 支持失败重试，单个块失败不影响其他块
• 🔄 并行上传: 多个文件块可以同时上传（如果支持）
• 📊 进度监控: 实时显示上传进度和状态
• ⚡ 稳定性强: 特别适合大文件和网络不稳定环境

文件大小限制

• 普通上传: 最大支持 10MB 的文件
• 分块上传: 理论上无限制（实际受COS服务限制）
• 智能切换: 文件超过 5MB 自动启用分块上传

支持的文件类型

图片文件

• JPEG (.jpg, .jpeg)
• PNG (.png)
• GIF (.gif)
• BMP (.bmp)
• WebP (.webp)

文档文件

• PDF (.pdf)
• Word (.doc, .docx)
• Excel (.xls, .xlsx)
• 文本文件 (.txt)

压缩文件

• ZIP (.zip)
• RAR (.rar)

安装

npm install upload-mcp
# or
pnpm add upload-mcp

MCP工具调用规则

单文件上传工具 (upload-file)

🔴【强制调用规则】：

• 当用户需要上传单个文件到COS时，AI助手必须立即调用此MCP工具
• 支持传入自定义目标路径，如不提供则自动生成
• 返回COS永久访问地址

参数说明：

• filePath (必填): 本地文件路径（绝对路径或相对路径）
• targetPath (可选): COS目标路径

开发

# 构建
pnpm --filter "upload-mcp" build

许可证

MIT