OSS MCP Server
About
Provides a bridge between AI systems and Ali OSS cloud storage, enabling file upload, download, listing, and management operations through a RESTful API.
Details
- Author
- 1yhy
- GitHub stars
- 6
- Downloads
- 442
- Categories
- File Management, Other, Developer Tools, Design, Workplace, AI, Media, Cloud Service, API, Frontend
- Tags
- #integration
Jump to
- Supports multiple Alibaba Cloud OSS configurations.
- Allows specifying an upload directory.
- Provides two tools: upload_to_oss and list_oss_configs.
- Integrates seamlessly with other MCP tools (Playwright, Figma, Filesystem).
- Runs over stdio or HTTP transport.
- Can be launched with an Inspector for debugging.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
OSS MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install globally with npm install -g oss-mcp or pnpm add -g oss-mcp. Configure one or more OSS accounts via the --oss-config command‑line argument, a .env file, or environment variables. Start the server using oss-mcp --oss-config='...' --stdio for stdio mode or oss-mcp --http -p 3000 for HTTP mode.
upload_to_oss
将文件上传到阿里云OSS
list_oss_configs
列出可用的阿里云OSS配置
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"oss mcp server": {
"oss-mcp": {
"command": "npx",
"args": [
"oss-mcp",
"--oss-config='{\"default\":{\"region\":\"oss-cn-shenzhen\",\"accessKeyId\":\"YOUR_KEY\",\"accessKeySecret\":\"YOUR_SECRET\",\"bucket\":\"YOUR_BUCKET\",\"endpoint\":\"oss-cn-shenzhen.aliyuncs.com\"}}'",
"--stdio"
]
}
}
}
}McpServers
{
"oss-mcp": {
"command": "npx",
"args": [
"oss-mcp",
"--oss-config='{\"default\":{\"region\":\"oss-cn-shenzhen\",\"accessKeyId\":\"YOUR_KEY\",\"accessKeySecret\":\"YOUR_SECRET\",\"bucket\":\"YOUR_BUCKET\",\"endpoint\":\"oss-cn-shenzhen.aliyuncs.com\"}}'",
"--stdio"
]
}
}一个基于Model Context Protocol (MCP)的服务器，用于将文件上传到阿里云OSS。此服务器使大型语言模型能够直接将文件上传到阿里云对象存储服务。
- 与Playwright MCP集成：可以先使用Playwright MCP抓取网页截图或下载网页资源，然后直接上传到阿里云OSS存储。
- 与Figma MCP集成：下载图片资源到本地后直接上传OSS、或者Figma网络文件直接上传OSS。
- 与Filesystem MCP集成：可以浏览和选择本地文件系统中的文件，然后一步上传到云存储。
- 数据备份流程：将重要数据从本地或其他服务自动备份到OSS。
- 媒体处理流程：结合其他处理工具，可以对图片、视频进行处理后直接上传并获取可访问的URL。
- 多OSS账号管理：便捷地在多个OSS账号间切换上传目标。
# 使用npm全局安装 npm install -g oss-mcp # 或使用pnpm全局安装 pnpm add -g oss-mcp
# 直接启动 (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
# 克隆仓库 git clone https://github.com/1yhy/oss-mcp.git cd oss-mcp # 安装依赖 pnpm install # 构建项目 pnpm build
在项目根目录创建.env文件，参考.env.example模板。您可以配置多个阿里云OSS服务：
# 默认OSS配置 OSS_CONFIG_DEFAULT={"region":"oss-cn-hangzhou","accessKeyId":"your-access-key-id","accessKeySecret":"your-access-key-secret","bucket":"your-bucket-name","endpoint":"oss-cn-hangzhou.aliyuncs.com"} # 其他OSS配置 OSS_CONFIG_TEST={"region":"oss-cn-beijing","accessKeyId":"your-access-key-id-2","accessKeySecret":"your-access-key-secret-2","bucket":"your-bucket-name-2","endpoint":"oss-cn-beijing.aliyuncs.com"}
# 设置环境变量并启动 pnpm dev --oss-config='{ "default": { "region": "oss-cn-shenzhen", "accessKeyId": "YOUR_KEY", "accessKeySecret": "YOUR_SECRET", "bucket": "BUCKET_NAME", "endpoint": "oss-cn-shenzhen.aliyuncs.com" }, "test": { "region": "oss-cn-beijing", "accessKeyId": "YOUR_KEY", "accessKeySecret": "YOUR_SECRET", "bucket": "BUCKET_NAME", "endpoint": "oss-cn-beijing.aliyuncs.com" } }'
- region: 阿里云OSS区域
- accessKeyId: 阿里云访问密钥ID
- accessKeySecret: 阿里云访问密钥Secret
- bucket: OSS存储桶名称
- endpoint: OSS终端节点
选项: -s, --stdio 使用stdio传输启动服务器 -h, --http 使用HTTP传输启动服务器 -p, --port HTTP服务器端口 (默认: 3000) -i, --inspect 使用Inspector工具启动 -?, --help 显示帮助信息
# 开发模式 pnpm dev # 启动服务 (stdio模式) pnpm start # 启动HTTP服务 pnpm start:http # 使用Inspector调试 pnpm inspect
- 在Cursor中打开设置（Settings）
- 转到MCP服务器（MCP Servers）部分
- 添加新服务器配置：
{ "mcpServers": { "oss-mcp": { "command": "npx", "args": [ "oss-mcp", "--oss-config='{\"default\":{\"region\":\"oss-cn-shenzhen\",\"accessKeyId\":\"YOUR_KEY\",\"accessKeySecret\":\"YOUR_SECRET\",\"bucket\":\"YOUR_BUCKET\",\"endpoint\":\"oss-cn-shenzhen.aliyuncs.com\"}}'", "--stdio" ] } } }
{ "mcpServers": { "oss-mcp": { "command": "npx", "args": [ "oss-mcp", "--oss-config='{\"default\":{\"region\":\"oss-cn-shenzhen\",\"accessKeyId\":\"YOUR_KEY\",\"accessKeySecret\":\"YOUR_SECRET\",\"bucket\":\"YOUR_BUCKET\",\"endpoint\":\"oss-cn-shenzhen.aliyuncs.com\"}, \"test\":{\"region\":\"oss-cn-shenzhen\",\"accessKeyId\":\"YOUR_KEY\",\"accessKeySecret\":\"YOUR_SECRET\",\"bucket\":\"YOUR_BUCKET\",\"endpoint\":\"oss-cn-shenzhen.aliyuncs.com\"}}'", "--stdio" ] } } }
- filePath: 本地文件路径（必需）
- targetDir: 目标目录路径（可选）
- fileName: 文件名（可选，默认使用原文件名）
- configName: OSS配置名称（可选，默认使用'default'）
# 发布到npm pnpm pub:release # 本地打包测试 pnpm publish:local
Persistent memory for AI agents. Store and retrieve files via 14 MCP tools with OAuth 2.0 auth. Free 10GB tier.
Quickly integrate with Tencent Cloud Storage (COS) and Data Processing (CI) capabilities powered
An MCP server for managing files and buckets on AWS S3. Requires AWS credentials for authentication.
Publish HTML, Markdown, KV, JSON, files to brewpage.app from AI assistants.
An MCP server for interacting with Dropbox files and services.
A read-only MCP server by CData that allows LLMs to query live Dropbox data. Requires the CData JDBC Driver for Dropbox.
An MCP server for integrating with Dropbox, allowing clients to interact with files and folders.
An MCP server for interacting with Dropbox, allowing clients to manage files and folders.
AI-first file sharing and collaboration. 251 MCP tools give agents a full workspace: file storage, branded shares, comments, workflows, and built-in RAG. 50GB free, no credit card.
Access and manage your Google Drive files and folders.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
