mcp-oss-upload

一个基于 Model Context Protocol (MCP) 的服务，提供 oss_upload 工具：上传本地文件到阿里云 OSS 并返回 CDN 链接。

安装

npm i mcp-oss-upload

或在本地开发目录运行：

npm install
npm start

MCP 客户端配置示例（无版本号引用）

在你的 MCP 客户端（如 Trae/Claude Desktop）中添加 stdio 服务器：

{
  "mcpServers": {
    "oss-upload": {
      "command": "node",
      "args": ["./node_modules/mcp-oss-upload/index.js"],
      "env": {
        "OSS_BUCKET": "dev-res-tishi",
        "OSS_ENDPOINT": "https://oss-cn-shanghai.aliyuncs.com",
        "OSS_ACCESS_KEY_ID": "<your-ak>",
        "OSS_ACCESS_KEY_SECRET": "<your-sk>",
        "CDN_URL": "https://dev-res.tishiii.com/"
      }
    }
  }
}

注意：配置不包含任何“之前的版本号”后缀，避免识别问题。

工具

oss_upload

入参：

• file：必填，本地文件路径
• objectKey：可选，自定义 OSS 对象键；默认：imgenx/YYYYMMDD/<文件名>
• env：可选，dev|prod|stag；默认 dev（会从 huadan 项目的 application-*.yml 读取）
• bucket|endpoint|accessKeyId|accessKeySecret|cdnUrl：可选，覆盖配置文件

返回：

{
  "objectKey": "imgenx/20251110/poster_female.jpg",
  "url": "https://dev-res.tishiii.com/imgenx/20251110/poster_female.jpg",
  "etag": "..."
}

配置来源

• 默认从项目路径：huadan-backend-feature/huadan-backend-feature/src/main/resources/application-<env>.yml 读取：
  • oss.bucket
  • oss.endpoint
  • oss.access_key_id
  • oss.access_key_secret
  • cdn.url
• 也可通过环境变量覆盖：OSS_BUCKET、OSS_ENDPOINT、OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET、CDN_URL

发布到 npm

1. 确认登录：npm whoami
2. 打包：npm run pack（生成 mcp-oss-upload-<version>.tgz）
3. 发布：npm publish

如需发布到你的 scope：修改 package.json 的 name 为 @<your-scope>/mcp-oss-upload。