yupao-oss-mcp-server

v1.0.4

Published

5 months ago

MCP 服务器：上传图片到鱼泡 OSS，支持单张和批量上传，自动生成永久 CDN 链接

Downloads

0High
0Medium
0Low

lx666

mcp oss aliyun image-upload cdn figma model-context-protocol

yupao-oss

上传图片到鱼泡内网 OSS 的 MCP 服务器

一个基于 Model Context Protocol (MCP) 的服务器，为 AI 工具提供图片上传到阿里云 OSS 的能力。支持单张和批量上传，自动生成永久 CDN 链接。

配置

方式 1：通过 npx 使用（推荐）

无需克隆仓库，直接在 MCP 客户端配置：

{
  "mcpServers": {
    "yupao-oss": {
      "command": "npx",
      "args": ["-y", "yupao-oss-mcp-server"],
      "env": {
        "OSS_BUCKET": "your-bucket-name",
        "OSS_ACCESS_KEY_ID": "your_access_key_id",
        "OSS_ACCESS_KEY_SECRET": "your_access_key_secret",
        "OSS_REGION": "oss-cn-beijing"
      }
    }
  }
}

方式 2：本地安装使用

# 克隆仓库
git clone https://github.com/FendSunShine/oss-mcp-server.git
cd oss-mcp-server

# 安装依赖
npm install

# 构建
npm run build

然后配置：

{
  "mcpServers": {
    "yupao-oss": {
      "command": "node",
      "args": ["/absolute/path/to/oss-mcp-server/dist/index.js"],
      "env": {
        "OSS_BUCKET": "your-bucket-name",
        "OSS_ACCESS_KEY_ID": "your_access_key_id",
        "OSS_ACCESS_KEY_SECRET": "your_access_key_secret",
        "OSS_REGION": "oss-cn-beijing"
      }
    }
  }
}

环境变量说明

| 变量名 | 必需 | 说明 | 默认值 | |--------|------|------|--------| | OSS_BUCKET | ✅ | OSS bucket 名称 | - | | OSS_ACCESS_KEY_ID | ✅ | OSS access key ID | - | | OSS_ACCESS_KEY_SECRET | ✅ | OSS access key secret | - | | OSS_REGION | ✅ | OSS 区域（如 oss-cn-beijing） | - | | OSS_CDN_DOMAIN | ❌ | CDN 域名 | https://cdn.yupaowang.com | | OSS_CDN_DIRECTORY | ❌ | CDN 目录前缀 | yupao_common |

使用场景

这个 MCP 服务器特别适合以下场景：

Figma 设计稿转代码：从 Figma 提取图片并上传到 OSS，获取永久 CDN 地址用于代码生成
AI 辅助开发：在 AI 对话中直接上传图片到 CDN
批量图片处理：一次性上传多张图片，自动生成 CDN 链接
设计资源管理：将临时图片链接转换为永久 CDN 地址

功能特性

✅ 单张图片上传
✅ 批量图片上传
✅ 自动生成唯一文件名（基于 SHA-256）
✅ 支持多种图片格式（png, jpg, jpeg, webp, gif, svg）
✅ 防止文件覆盖
✅ 详细的日志记录
✅ 完整的错误处理

安装

npm install

配置

环境变量

复制 .env.example 为 .env 并填入实际配置：

cp .env.example .env

必需的环境变量：

OSS_BUCKET: OSS bucket 名称
OSS_ACCESS_KEY_ID: OSS access key ID
OSS_ACCESS_KEY_SECRET: OSS access key secret
OSS_REGION: OSS 区域（如 oss-cn-beijing）

可选的环境变量（有默认值）：

OSS_CDN_DOMAIN: CDN 域名（默认：https://cdn.yupaowang.com）
OSS_CDN_DIRECTORY: CDN 目录前缀（默认：yupao_common）

使用方法

开发模式

npm run dev

生产模式

npm run build
npm start

MCP 客户端配置

Kiro IDE

在项目的 .kiro/settings/mcp.json 中配置：

{
  "mcpServers": {
    "yupao-oss": {
      "command": "node",
      "args": ["/path/to/oss-mcp-server/dist/index.js"],
      "env": {
        "OSS_BUCKET": "your-bucket-name",
        "OSS_ACCESS_KEY_ID": "your_key_id",
        "OSS_ACCESS_KEY_SECRET": "your_key_secret",
        "OSS_REGION": "oss-cn-beijing"
      }
    }
  }
}

Claude Desktop

在 ~/Library/Application Support/Claude/claude_desktop_config.json 中配置：

{
  "mcpServers": {
    "yupao-oss": {
      "command": "node",
      "args": ["/path/to/oss-mcp-server/dist/index.js"],
      "env": {
        "OSS_BUCKET": "your-bucket-name",
        "OSS_ACCESS_KEY_ID": "your_key_id",
        "OSS_ACCESS_KEY_SECRET": "your_key_secret",
        "OSS_REGION": "oss-cn-beijing"
      }
    }
  }
}

Cursor IDE

在 Cursor 设置中添加 MCP 服务器配置。

MCP 工具

upload_image

上传单张图片到 OSS。

参数：

url (string, 必需): 图片的 HTTP(S) URL
fileType (string, 必需): 文件类型，支持 png/jpg/jpeg/webp/gif/svg

返回：

{
  "success": true,
  "cdnUrl": "https://cdn.yupaowang.com/yupao_common/a1b2c3d4.png",
  "fileSize": 102400
}

upload_images_batch

批量上传多张图片到 OSS。