Plugin Light

Appearance

文件上传 ​

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)

安装 ​

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

MCP工具调用规则 ​

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

🔴【强制调用规则】：

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

参数说明：

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

开发 ​

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

许可证 ​

MIT