caomeiyouren/sharp-cloud-uploader repository overview

wget https://raw.githubusercontent.com/CaoMeiYouRen/sharp-cloud-uploader/refs/heads/master/docker-compose.yml

vim docker-compose.yml  # 也可以是你喜欢的编辑器

docker-compose up -d

# 下载源码
git clone https://github.com/CaoMeiYouRen/sharp-cloud-uploader.git  --depth=1
cd sharp-cloud-uploader
# 安装依赖
pnpm i --frozen-lockfile
# 构建项目
pnpm build
# 启动项目
pnpm start

{
    "url": "https://example.com/image.jpg"
}

{
    "url": "https://example.com/bucket-prefix/20231001123456789-abcdefg.jpg",
    "success": true,
    "status": 200
}

{
    "status": 400,
    "message": "URL is required"
}

curl -X POST -H "Content-Type: image/jpeg" --data-binary @image.jpg http://localhost:3000/upload-from-body

{
    "url": "https://example.com/bucket-prefix/20231001123456789-abcdefg.jpg",
    "success": true,
    "status": 200
}

{
    "status": 400,
    "message": "Invalid image format"
}

const uploadFromUrl = async () => {
    const url = "https://example.com/image.jpg";
    const response = await fetch("http://localhost:3000/upload-from-url", {
        method: "POST",
        headers: {
            "Content-Type": "application/json",
        },
        body: JSON.stringify({ url }),
    });
    const data = await response.json();
    console.log(data);
};

uploadFromUrl();

const uploadFromBody = async () => {
    const imageFile = document.getElementById("image-file").files[0];
    const reader = new FileReader();
    reader.onload = async () => {
        const response = await fetch("http://localhost:3000/upload-from-body", {
            method: "POST",
            headers: {
                "Content-Type": imageFile.type,
            },
            body: reader.result,
        });
        const data = await response.json();
        console.log(data);
    };
    reader.readAsArrayBuffer(imageFile);
};

uploadFromBody();

pnpm run build    # 会同时生成 dist/mcp-local.mjs

{
    "mcpServers": {
        "sharp-cloud-uploader": {
            "command": "node",
            "args": ["/path/to/sharp-cloud-uploader/dist/mcp-local.mjs"],
            "env": {
                "STORAGE_TYPE": "s3",
                "S3_REGION": "auto",
                "S3_BUCKET_NAME": "images",
                "S3_ACCESS_KEY_ID": "<your-key>",
                "S3_SECRET_ACCESS_KEY": "<your-secret>",
                "S3_ENDPOINT": "https://xxx.r2.cloudflarestorage.com",
                "S3_BASE_URL": "https://oss.example.com",
                "BUCKET_PREFIX": "uploads/"
            }
        }
    }
}

pnpm run mcp:local:dev    # 开发模式，使用 tsx 直接运行源码
pnpm run mcp:local        # 生产模式，使用编译产物

POST https://your-app.vercel.app/mcp

# 运行端口
PORT=3000

# 超时时间(ms)
# 如果在 vercel 中运行，则还要修改 vercel.json 中的 maxDuration 字段(单位：秒)
TIMEOUT=60000

NODEJS_HELPERS=0
# 是否写入日志到文件
LOGFILES=false

# 日志级别
# LOG_LEVEL=http

# 最大请求体大小(字节)，默认 100MB
# 受 Vercel Functions 的限制，通过请求体上传时最大不超过 4.5 MB（通过 url 上传则不受限制），详见 https://vercel.com/docs/storage/vercel-blob/server-upload
# 受 Cloudflare Workers 的限制，通过请求体上传时最大不超过 100 MB（通过 url 上传则不受限制），详见 https://developers.cloudflare.com/workers/platform/limits
# MAX_BODY_SIZE=104857600

# 图片压缩质量(1-100)，默认 90
# IMAGE_QUALITY=90

# 授权密钥（Bearer 认证）。可选，如果设置，则所有请求都需要携带此密钥
AUTH_TOKEN=

# 文件名前缀
# BUCKET_PREFIX=

# 存储类型，可选值：s3, r2, vercel-blob
# 如果服务部署在 Cloudflare Workers，并且想要存储到 R2，则可以设置为 'r2'，此时需要修改 wrangler.toml 中的 r2_buckets 相关配置；
# 如果服务部署在其他平台，想要存储到 R2，请使用 R2 的 S3 兼容接口，参考 https://developers.cloudflare.com/r2/api/s3/api，此时设置为 's3'
# STORAGE_TYPE=s3

# S3 基础 URL
# S3_BASE_URL=

# S3 区域
# S3_REGION=

# S3 存储桶名称
# S3_BUCKET_NAME=

# S3 访问密钥 ID
# S3_ACCESS_KEY_ID=

# S3 秘密访问密钥
# S3_SECRET_ACCESS_KEY=

# S3 端点
# S3_ENDPOINT=

# Vercel Blob 令牌，参考 https://vercel.com/docs/storage/vercel-blob
# VERCEL_BLOB_TOKEN=

# R2 基础 URL，仅 Cloudflare Workers 绑定 Cloudflare R2 Storage 可用
# R2_BASE_URL=

npm run dev

npm run build

npm run test           # 运行所有测试
npm run test:watch     # watch 模式
npm run test:coverage  # 覆盖率报告

npm run lint

npm run commit