• Cursor
  • Claude Code
  • Claude Desktop

OSSPUT专注开发 让 AI 管理你的云文件

面向开发流程的 MCP 与 CLI：在 IDE 里让 Agent 上传、列举阿里云 OSS，返回可引用链接。凭证保存在本机 ~/.config/ossput/，不进入对话。

安装与示例 npm

能力

OSSPUT 面向开发流程：本地文件进 OSS、Agent 或脚本拿到 URL。不是通用图床网页，也不需要自建上传 API。

  • Agent 上传与拿链接

    在对话中说明文件路径与 OSS 子目录，Agent 调用 MCP 上传，返回 objectUrl。

  • 列举与预览

    list_objects 按目录查看；format=markdown 可在对话里预览图片列表。

  • 批量与 CLI

    单次最多 20 个文件批量上传；put / ls 与 MCP 共用 profile。

  • 多账号 / 多项目

    多个 Bucket 用 profile 管理；.ossput.json 绑定环境，团队共享绑定、不共享密钥。

  • 一次 setup

    向导配置 RAM、检测连通、注册 MCP（Cursor / Claude 等）、安装用户级 Skill。

  • 安全默认

    密钥仅终端输入；删除默认关闭。详见RAM 策略示例。

RAM 策略示例

推荐使用 RAM 子账号，按 Bucket 与前缀收窄权限。将 your-bucket、your-prefix 替换为实际值；删除权限仅在需要 delete_object 且 profile 开启时授予。

  • OssputListAndRead — 列举、读取、探测对象（上传前 Head、列举目录）
  • OssputWrite — PutObject 上传至指定前缀
  • OssputDeleteOptional — 可选；仅清理误传文件时启用
ram-policy.example.json
下载 
{
  "Version": "1",
  "Statement": [
    {
      "Sid": "OssputListAndRead",
      "Effect": "Allow",
      "Action": [
        "oss:ListObjects",
        "oss:GetObject",
        "oss:HeadObject"
      ],
      "Resource": [
        "acs:oss:*:*:your-bucket",
        "acs:oss:*:*:your-bucket/your-prefix/*"
      ]
    },
    {
      "Sid": "OssputWrite",
      "Effect": "Allow",
      "Action": ["oss:PutObject"],
      "Resource": ["acs:oss:*:*:your-bucket/your-prefix/*"]
    },
    {
      "Sid": "OssputDeleteOptional",
      "Effect": "Allow",
      "Action": ["oss:DeleteObject"],
      "Resource": ["acs:oss:*:*:your-bucket/your-prefix/*"],
      "Comment": "仅当 profile 开启 allowDelete 且确需 delete_object 时授予"
    }
  ]
}
MCP

工具列表

连接 OSSPUT MCP 后，Agent 可调用以下工具（均可选 profile 覆盖项目绑定）。

工具名 作用 典型场景
upload_file 上传单个本地文件 截图、附件、构建产物
batch_upload_file 批量上传（≤20 个/次） 多张配图、一组资源文件
list_objects 列举对象，可 Markdown 预览图 「看看 docs 目录有哪些图」
list_directories 列举目录前缀 浏览 Bucket 内文件夹结构
list_profiles 列出账号与当前生效 profile 多环境时确认用哪个 Bucket
get_setup_status 检查配置与 MCP 是否已注册 排查「连不上 MCP」
delete_object 删除对象（需 profile 开启且确认） 清理误传文件（默认关闭）
prepare_upload 高级：仅生成 Presign 自定义上传流程
confirm_upload 高级：确认上传结果 与 prepare 成对使用

常用 CLI：setup · put · ls · dirs · doctor · profile · rm --confirm

安装与使用示例

需要 Node.js 18+。任选下方包管理器执行 setup 进入交互向导；完成后重启 IDE。

  1. 1

    安装并配置

    所有方式最终都会运行 setup 向导：创建 profile、检测 Bucket、注册 MCP、安装 Skill。

    推荐：无需全局安装，始终拉取最新包。

    一次性运行 
    npx -y ossput setup

    自检：ossput doctor · 升级包后重新 setup 可刷新 MCP 配置

  2. 2

    在 IDE 里让 Agent 上传（示例）

    你 把 ./screenshot.png 传到 OSS 的 docs/ 目录，给我链接。

    Agent 调用 upload_file，参数 localPath、subdir=docs/

    返回 objectUrl → 插入文档或回复给你

    对象 Key 形如 docs/2026/05/<uuid>.png（含 profile 的 prefix，不保留原文件名）。

  3. 3

    终端命令（示例）

    上传 
    ossput put ./photo.png --subdir demo/
    列举图片（Markdown） 
    ossput ls demo/ --markdown --images
    指定 profile 
    ossput --profile staging put ./build.zip --subdir releases/