OSS MCP 服务器 🚀
2025.03.23
1
TypeScript云存储文件上传文件管理
OSS MCP 服务器是一个基于Model Context Protocol (MCP)的服务器，专门用于将文件上传到阿里云对象存储服务(OSS)。它提供了简单易用的接口，支持多个阿里云OSS配置，并能与其他MCP工具无缝集成，实现高效的文件上传和管理工作流程。
View on GitHub
Overview
基本能力
产品定位
OSS MCP 服务器是一个专门用于文件上传和管理的工具，特别针对阿里云OSS服务进行了优化。
核心功能
- 支持多个阿里云OSS配置
- 可指定上传目录
- 提供简单易用的接口
- 支持与其他MCP工具集成
适用场景
- 与Playwright MCP集成：抓取网页截图或下载网页资源后直接上传到OSS
- 与Figma MCP集成：下载图片资源到本地后直接上传OSS
- 与Filesystem MCP集成：浏览和选择本地文件系统中的文件后上传到云存储
- 数据备份流程：将重要数据从本地或其他服务自动备份到OSS
- 媒体处理流程：结合其他处理工具，对图片、视频进行处理后直接上传
- 多OSS账号管理：便捷地在多个OSS账号间切换上传目标
工具列表
- 上传文件到OSS (
upload_to_oss) - 参数: filePath(必需), targetDir(可选), fileName(可选), configName(可选)
- 列出可用的OSS配置 (
list_oss_configs) - 无参数，返回所有可用的OSS配置名称
常见问题解答
(文档中未提供具体常见问题解答)
使用教程
使用依赖
需要安装Node.js环境
安装教程
使用npm安装
# 使用npm全局安装
npm install -g oss-mcp
# 或使用pnpm全局安装
pnpm add -g oss-mcp
从源码安装
# 克隆仓库
git clone https://github.com/1yhy/oss-mcp.git
cd oss-mcp
# 安装依赖
pnpm install
# 构建项目
pnpm build
调试方式
# 直接启动 (stdio模式)
oss-mcp --oss-config='{\"default\":{\"region\":\"oss-cn-shenzhen\",\"accessKeyId\":\"YOUR_KEY\",\"accessKeySecret\":\"YOUR_SECRET\",\"bucket\":\"YOUR_BUCKET\",\"endpoint\":\"oss-cn-shenzhen.aliyuncs.com\"}}'
# 使用Inspector调试
oss-mcp --oss-config='{ "region": "oss-cn-shenzhen", "accessKeyId": "YOUR_KEY", "accessKeySecret": "YOUR_SECRET", "bucket": "BUCKET_NAME", "endpoint": "oss-cn-shenzhen.aliyuncs.com" }' --inspect