my-oss-upload-mcp

一个轻量的阿里云 OSS 文件、图片、设计切图上传MCP Server。

零依赖，原生实现 MCP 协议，Node.js 16+ 即可运行。

Demo

demo

适用场景

可配合蓝湖 mcp, figma mcp 下载切图，实现流程化切图上传文件到 OSS → 返回 CDN 链接

你的后台管理系统使用阿里云 OSS STS 临时凭证直传文件，上传后调用后台接口注册文件信息。本工具自动完成以下流程：

解析 STS 凭证 → 上传文件到 OSS → 调用后台接口注册 → 返回 CDN 链接

配合 AI IDE（如 Kiro、Cursor、Windsurf 等）使用，可以在对话中直接上传图片并获取 CDN 链接。

提供的工具

| 工具名 | 说明 | |--------|------| | upload_image | 上传单个本地图片，返回 CDN 链接 | | batch_upload | 批量上传目录下所有图片，返回所有 CDN 链接 | | list_uploads | 查看后台最近上传的文件列表 |

支持格式：png / jpg / jpeg / gif / webp / svg / bmp / ico

快速开始

1. 配置 MCP

在你的 AI IDE 的 MCP 配置文件中添加：

{
  "mcpServers": {
    "my-oss-upload-mcp": {
      "command": "node",
      "args": ["/path/to/my-oss-upload-mcp/server.js"],
      "env": {
        "ADMIN_COOKIE": "你的后台登录 cookie/Token",
        "ADMIN_PAGE_URL": "https://your-domain.com/admin/attach/",
        "REGISTER_URL": "https://your-domain.com/admin/attach/edit",
        "CDN_PREFIX": "https://cdn.your-domain.com/",
        "OSS_ENDPOINT": "https://your-bucket.oss-cn-shanghai.aliyuncs.com",
        "OSS_BUCKET": "your-bucket-name",
        "OSS_PATH_PREFIX": "attach"
      },
      "disabled": false,
      "autoApprove": ["upload_image", "batch_upload", "list_uploads"]
    }
  }
}

2. 环境变量说明

| 变量名 | 必填 | 说明 | |--------|------|------| | ADMIN_COOKIE | ✅ | 后台管理系统的登录 cookie | | ADMIN_PAGE_URL | ✅ | 后台文件管理页面 URL（用于解析 STS 凭证） | | REGISTER_URL | ✅ | 上传后注册文件的接口 URL | | CDN_PREFIX | ✅ | CDN 链接前缀，如 https://cdn.example.com/ | | OSS_ENDPOINT | ✅ | 阿里云 OSS Endpoint，如 https://bucket.oss-cn-shanghai.aliyuncs.com | | OSS_BUCKET | ✅ | OSS Bucket 名称 | | OSS_PATH_PREFIX | ❌ | 文件路径前缀，默认 attach |

3. 获取 Cookie/Token

填入 ADMIN_COOKIE 环境变量

STS 凭证解析

OSS 上传凭证：

AccessKeyId
AccessKeySecret
SecurityToken

如果你的后台是通过接口返回凭证的，需要修改 getCredentials() 方法。

工作原理

┌─────────────┐     ┌──────────────────┐     ┌─────────────┐
│  AI IDE     │────▶│  my-oss-upload   │────▶│  后台页面    │
│  (MCP Client)│     │  (MCP Server)    │     │  解析 STS   │
└─────────────┘     └──────┬───────────┘     └─────────────┘
                           │
                    ┌──────▼───────────┐
                    │  阿里云 OSS      │
                    │  PUT 上传文件    │
                    └──────┬───────────┘
                           │
                    ┌──────▼───────────┐
                    │  后台注册接口    │
                    │  POST 注册信息   │
                    └──────┬───────────┘
                           │
                    ┌──────▼───────────┐
                    │  返回 CDN 链接   │
                    └──────────────────┘

注意事项

Cookie 有过期时间，失效后需要重新登录后台并更新 ADMIN_COOKIE
STS 临时凭证也有过期时间（通常 15 分钟 ~ 1 小时），工具会在凭证失效时自动重新获取
上传的文件名格式为 file{timestamp}.{ext}，备注默认使用原始文件名

License

MIT

MCP Servers