# 阿里云对象存储 OSS

通过 MCP 查询 OSS 存储空间列表、属性、容量与文件数量。

- 类型：MCP
- 权限：只读查询
- 门槛：需授权账号、需 API Key
- 官方入口：https://help.aliyun.com/zh/oss/developer-reference/oss-mcp-server-alpha
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/aliyun-oss/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。

## 接入前准备

需要可访问 OSS 的阿里云账号与授权凭证，Node.js 不低于 18.20.5。MCP 目前为 Alpha，只提供存储空间信息查询；OSS 资源和请求费用以产品规则为准。

## 接入步骤

1. 按官方文档准备具备目标 OSS 查询权限的 AccessKey，在本地填写下方 stdio 配置。 [官方入口](https://help.aliyun.com/zh/oss/developer-reference/oss-mcp-server-alpha)
2. 使用临时身份凭证时，按文档额外添加 OSS_SECURITY_TOKEN；需要限定地域或端点时再配置 OSS_REGION、OSS_ENDPOINT。 [官方入口](https://help.aliyun.com/zh/oss/developer-reference/oss-mcp-server-alpha)
3. 将配置加入支持本地 stdio 的 MCP 客户端并启用，服务由 npx 启动；无需把本机 HTTP 示例当成公网端点。 [官方入口](https://help.aliyun.com/zh/oss/developer-reference/oss-mcp-server-alpha)

## 验证方法

先查看工具列表，再列举授权范围内的存储空间并核对名称；空列表可能表示没有资源，鉴权错误需检查凭证和权限。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

所查官方接入资料未能确认该工具的具体调用费用和免费额度；实际费用按官方产品规则核实。 [官方来源](https://help.aliyun.com/zh/oss/developer-reference/oss-mcp-server-alpha)（核对日期：2026-11-05）

## 安装配置

### JSON

```
{
  "mcpServers": {
    "aliyun-oss": {
      "command": "npx",
      "args": [
        "-y",
        "alibabacloud-oss-mcp-server@alpha"
      ],
      "env": {
        "OSS_ACCESS_KEY_ID": "${OSS_ACCESS_KEY_ID}",
        "OSS_ACCESS_KEY_SECRET": "${OSS_ACCESS_KEY_SECRET}"
      }
    }
  }
}
```

### Claude Code

```
claude mcp add --env 'OSS_ACCESS_KEY_ID=${OSS_ACCESS_KEY_ID}' --env 'OSS_ACCESS_KEY_SECRET=${OSS_ACCESS_KEY_SECRET}' --transport stdio 'aliyun-oss' -- 'npx' '-y' 'alibabacloud-oss-mcp-server@alpha'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.aliyun-oss]
command = "npx"
args = ["-y","alibabacloud-oss-mcp-server@alpha"]
env_vars = ["OSS_ACCESS_KEY_ID","OSS_ACCESS_KEY_SECRET"]
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

## 核验与来源

2026-11-05 核对官方身份：[依据](https://help.aliyun.com/zh/oss/developer-reference/oss-mcp-server-alpha)。阿里云 OSS 官方文档给出三个查询工具、npm 包和 stdio 配置；当前为 Alpha 版本。

官方原文摘录（2026-11-05，来自上述依据）：

```
"args": ["-y", "alibabacloud-oss-mcp-server@alpha"],
```


[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)