Aliyun OSS MCP Server
● Activeio.github.xiaobinger/oss-mcp-server
Aliyun OSS file tools for MCP: upload, replace, download, zip, delete, signed URLs.
Connect this server
One click to install, or copy the config below. Suits: Claude Desktop · Cursor.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"oss-mcp-server": {
"command": "uvx",
"args": [
"oss-mcp-server"
],
"env": {
"OSS_ACCESS_KEY_ID": "<your OSS_ACCESS_KEY_ID>",
"OSS_ACCESS_KEY_SECRET": "<your OSS_ACCESS_KEY_SECRET>",
"OSS_ENDPOINT": "<your OSS_ENDPOINT>",
"OSS_BUCKET": "<your OSS_BUCKET>",
"OSS_SECURITY_TOKEN": "<your OSS_SECURITY_TOKEN>",
"OSS_PUBLIC_READ": "false"
}
}
}
}claude mcp add --env OSS_ACCESS_KEY_ID='<your OSS_ACCESS_KEY_ID>' --env OSS_ACCESS_KEY_SECRET='<your OSS_ACCESS_KEY_SECRET>' --env OSS_ENDPOINT='<your OSS_ENDPOINT>' --env OSS_BUCKET='<your OSS_BUCKET>' --env OSS_SECURITY_TOKEN='<your OSS_SECURITY_TOKEN>' --env OSS_PUBLIC_READ=false --transport stdio oss-mcp-server -- uvx oss-mcp-servercodex mcp add oss-mcp-server --env OSS_ACCESS_KEY_ID='<your OSS_ACCESS_KEY_ID>' --env OSS_ACCESS_KEY_SECRET='<your OSS_ACCESS_KEY_SECRET>' --env OSS_ENDPOINT='<your OSS_ENDPOINT>' --env OSS_BUCKET='<your OSS_BUCKET>' --env OSS_SECURITY_TOKEN='<your OSS_SECURITY_TOKEN>' --env OSS_PUBLIC_READ=false -- uvx oss-mcp-servercode --add-mcp '{"name":"oss-mcp-server","type":"stdio","command":"uvx","args":["oss-mcp-server"],"env":{"OSS_ACCESS_KEY_ID":"<your OSS_ACCESS_KEY_ID>","OSS_ACCESS_KEY_SECRET":"<your OSS_ACCESS_KEY_SECRET>","OSS_ENDPOINT":"<your OSS_ENDPOINT>","OSS_BUCKET":"<your OSS_BUCKET>","OSS_SECURITY_TOKEN":"<your OSS_SECURITY_TOKEN>","OSS_PUBLIC_READ":"false"}}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.
- OSS_ACCESS_KEY_IDrequiredsecretAliyun AccessKey ID with access to the target OSS bucket.
- OSS_ACCESS_KEY_SECRETrequiredsecretAliyun AccessKey Secret paired with OSS_ACCESS_KEY_ID.
- OSS_ENDPOINTrequiredOSS endpoint, for example oss-cn-hangzhou.aliyuncs.com.
- OSS_BUCKETrequiredOSS bucket name.
- OSS_SECURITY_TOKENsecretOptional STS security token for temporary credentials.
- OSS_PUBLIC_READWhether the bucket is public-read; true or false.
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- Files & Storage
- Version
- 0.1.0
- Registry
- active
- Published
- 11/17/2026
Is it safe? Is it maintained?
Serverdex check: Nov 19, 2026Mostly fine: Aliyun OSS MCP Server is maintained.
- Maintained
- Active
- Last commit 5 days ago (Nov 17, 2026), 0 open issues.
- Official registry
- Active
- Published as io.github.xiaobinger/oss-mcp-server in the official MCP registry, version 0.1.0.
- Source
- No licence found
- Public repository, but GitHub reports no recognised licence (1 stars). Check the README before shipping it in a product.
- Runs
- On your machine
- A local PyPI package started by your client; it can reach whatever your user account can.
- Credentials
- 5 required
- Declared environment variables: OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET, OSS_ENDPOINT, OSS_BUCKET…. They stay on your machine; the config on this page shows where each goes.
- Owner
- Unclaimed
- Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.
Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.
On GitHub
read Nov 18, 2026- Stars
- 1
- Forks
- 0
- Last push
- Nov 17, 2026
- License
- —
Python
From the README
OSS MCP Server 把阿里云 OSS 变成 AI 可以直接调用的文件工具集 上传 · 替换 · 下载 · 目录打包 · 删除 · 访问地址 · 多分组认证 · 跨平台托管 在 MCP 客户端里说一句「从生产 OSS 下载 lstd/pay/a.png」,模型会自动把「生产」匹配到对应认证分组和 Bucket,然后调用下载工具。 目录 • 功能特性 • 项目结构 • 快速开始 • 认证分组配置 • MCP 工具 • 接入 MCP 客户端 • HTTP Bearer Token 认证 • 服务管理脚本 • 命令行工具 • 测试 • 发布(维护者) • 日志与排错 • 安全建议 • 已知限制 功能特性 • 文件存在性判断:基于 OSS HEAD 请求精确判断对象是否存在,不把目录前缀误判为文件。 • 上传:支持本地文件和网络 URL,上传时可指定对象 ACL(private / public-read / public-read-write / default)。 • 替换:用本地文件替换 OSS 上已有对象;默认保留原对象路径(URL 不变),也可按本地文件名改名并删除旧对象。 • 下载:支持单文件、多文件和整个目录;多文件与目录自动打包为 ZIP,避免大量小文件逐个落盘。 • 删除:支持单个删除和批量删除;批量删除自动去重,并按 OSS 限制每 1000 个一批提交。 • 访问地址:公共读 Bucket 可使用自定义域名直链;私有 Bucket 自动生成带有效期的签名 URL。 • 多分组认证:一个配置文件管理多套 AccessKey、Endpoint、Bucket,并通过别名做自然语言路由。 • 默认路径前缀:分组可配置 default_prefix;MCP 工具传 a.png 会自动补成 lstd/pay/a.png,已带前缀的路径不会重复拼接。 • HTTP Bearer 认证:HTTP/SSE 模式支持 Bearer Token;监听非本机地址时强制配置,避免 OSS 能力裸奔。 • 两种接入方式:MCP 客户端本地拉起(stdio),或作为后台 HTTP 服务运行(streamable-http / SSE)。 • 跨平台托管:提供 Linux / macOS 和 Windows 的启动、停止、重启、状态、日志脚本。 • 可离线验证:冒烟测试使用假的 Bucket 客户端,不依赖真实 OSS 凭证即可运行。 项目结构 分层约定: 运行时还会自动生成 logs/、run/ 和 Python 的 pycache/,它们都不会进入 Git。 快速开始 1. 环境要求 • Python 3.10 及以上 • 能访问阿里云 OSS 的网络环境 • 具备目标 Bucket 读写权限的 AccessKey,或 STS 临时凭证 2. 准备运行环境 推荐直接使用服务管理脚本,start / restart 前会自动完成: 1. 检测项目虚拟环境 .venv 或 venv; 2. 都不存在时,用 PATH 中的 Python 3.10+ 创建 .venv; 3. 升级该虚拟环境的 pip; 4. 检测 oss2 / mcp / uvicorn,缺失时执行 pip install -r requirements.txt; 5.…
Read the full README on GitHub →Alternatives to Aliyun OSS MCP Server
All Aliyun OSS MCP Server alternatives →Best Files & Storage servers →The most-starred Files & Storage servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| butterbase-ai MCP | 3,033 | Nov 2026 | Needs sign-in |
| ProxmoxMCP-Plus | 661 | Nov 2026 | Local / not checked |
| Directory | 208 | Aug 2026 | Working |
| Unraid RMCP | 153 | Nov 2026 | Local / not checked |
| Floodgate | 106 | Sep 2026 | Local / not checked |
Aliyun OSS MCP Server: questions people ask
- Is Aliyun OSS MCP Server a remote or a local MCP server?
- According to its entry in the official MCP registry, Aliyun OSS MCP Server ships as a local package (PyPI) that your client starts on your machine.
- Does Aliyun OSS MCP Server need an API key?
- Its registry entry declares 5 required environment variables: OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET, OSS_ENDPOINT, OSS_BUCKET…. The config on this page shows where each goes.
- Is Aliyun OSS MCP Server safe to use?
- Mostly fine: Aliyun OSS MCP Server is maintained. In detail — maintained: Active; official registry: Active; source: No licence found; runs: On your machine; credentials: 5 required. Serverdex check of Nov 19, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
- Is Aliyun OSS MCP Server still maintained?
- Active: the repository's last commit 5 days ago. Last push Nov 17, 2026, 1 GitHub stars. Read from GitHub on Nov 18, 2026.
- How do I add Aliyun OSS MCP Server to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More from xiaobinger
All 2 servers by xiaobinger →More Files & Storage servers
Browse all Files & Storage →ReClip
yagyaanshK
Inspect and download authorized media or precise clips locally with yt-dlp.
emperor-folder
yarenty
List, read, search and (opt-in) write, edit and move files inside one folder, never outside it.
Yourimageshare
yourimageshare
MCP server exposing the YourImageShare upload API (upload/list/delete) as tools for AI agents.
Ziplark
zhitongblog
Archive server: grep, read, extract, edit, convert & create ZIP, 7z, tar, RAR, ISO, DEB, RPM, CAB.
MCP File Tools
zoster81
Secure encoding-aware filesystem tools with atomic writes, legacy encodings, and typed errors
ImageKit DAM
imagekit-developer
Official ImageKit media library server: search, upload, organize, tag, share and manage assets.
Add the badge to your site
Show visitors that Aliyun OSS MCP Server is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/io-github-xiaobinger-oss-mcp-server?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Aliyun OSS MCP Server — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/io-github-xiaobinger-oss-mcp-server?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-xiaobinger-oss-mcp-server) [](https://serverdex.io/install/vscode/io-github-xiaobinger-oss-mcp-server) [](https://serverdex.io/install/claude-code/io-github-xiaobinger-oss-mcp-server)One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.
Install buttons — HTML for your docs
<a href="https://serverdex.io/install/cursor/io-github-xiaobinger-oss-mcp-server"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-xiaobinger-oss-mcp-server"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-xiaobinger-oss-mcp-server"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>Same buttons as plain links for a docs page or website.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).