Aliyun OSS MCP Server

● Active

io.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.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

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"
      }
    }
  }
}
One line, from the terminal
Claude Code
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-server
OpenAI Codex CLI
codex 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-server
VS Code
code --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.

Environment variables
  • 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
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 19, 2026

Mostly 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 →

The most-starred Files & Storage servers in the index, with their live-check result.

ServerStarsLast pushLive check
butterbase-ai MCP3,033Nov 2026Needs sign-in
ProxmoxMCP-Plus661Nov 2026Local / not checked
Directory208Aug 2026Working
Unraid RMCP153Nov 2026Local / not checked
Floodgate106Sep 2026Local / 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.
  1. cURL Generator MCPHTTP requests, signed code generation, GateShell/SSH execution and file transfer.★ 1
Browse all Files & Storage →

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.

Aliyun OSS MCP Server — listed on Serverdex

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

[![Aliyun OSS MCP Server — listed on Serverdex](https://serverdex.io/brand/badge.svg)](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.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-xiaobinger-oss-mcp-server) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-xiaobinger-oss-mcp-server) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](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).