您的位置首页 >人工智能 >

搭建 OSS MCP Server,让大模型直接调用阿里云 OSS 存储

我们可以自己写一个 MCP Server,把阿里云 OSS 封装成 MCP 协议工具,大模型就能直接读写、查询、上传下载 OSS 里的文件,不用手动写一堆 OSS SDK 调用代码,这也是现在 AI Agent 开发里很实用的方案,很多做本地 Agent、Cursor、Claude Desktop 的开发者都在做这个改造。传统方式下大模型没办法直接访问对象存储,想要读取 OSS 里的文档、图片、日志,都要开发中转接口,还要处理鉴权、异常、路径校验,接入成本很高;MCP 协议刚好给 AI 提供标准化工具调用能力,我们只需要把 OSS 的接口包装成 MCP 标准工具,给模型暴露上传、下载、列出文件、删除、获取文件链接这些动作,模型收到用户指令之后,就可以自主操作 OSS 资源。整套方案主要分为依赖准备、MCP 工具定义、OSS 鉴权封装、本地调试、客户端接入这几块,做好权限控制之后,就可以交给 Agent 使用,同时一定要做好访问权限隔离,避免模型误删重要文件。

一、核心能力规划(MCP 对外暴露工具)

工具名称功能说明适用场景
oss_list_objects列出指定前缀下的 OSS 文件列表模型查找 OSS 里的文档、素材
oss_get_object读取 OSS 文件内容、下载文件读取 PDF、txt、csv 给模型做分析
oss_put_object上传内容 / 文件到 OSS模型生成报告、截图、导出结果存 OSS
oss_delete_object删除 OSS 对象清理临时文件
oss_get_presigned_url生成临时访问签名链接模型输出可访问的文件地址

二、开发与部署步骤

  1. 准备环境:Python / Node.js 任选,安装 MCP SDK、阿里云 OSS SDK,准备好阿里云 AccessKey、Bucket 名称、Endpoint
  2. 编写 MCP Server 主程序:初始化 MCP 服务实例,注册上面的 OSS 工具,定义每个工具入参(bucket、key、prefix 等)
  3. 封装 OSS 底层逻辑:把 SDK 的调用包一层,增加参数校验、文件名过滤、大小限制,拦截高危操作
  4. 鉴权配置:推荐使用 RAM 子账号,只给这个 Bucket 最小权限,不要用主账号 AccessKey
  5. 本地测试启动:以 stdio 模式运行 MCP Server,用 MCP Inspector 测试工具调用是否正常
  6. 在 AI 客户端配置:Claude Desktop、Cursor、Dify 等支持 MCP 的客户端,添加这个 Server 的启动命令
  7. 业务验证:向模型下发指令,比如 “读取 OSS 里 report.txt 并总结”,验证模型能不能自动调用 OSS 工具

三、重点风险与限制

  • 权限风险:如果权限放太宽,模型可能收到指令后删除、覆盖业务文件,建议禁止直接删除正式文件,增加白名单前缀
  • 流量与费用:模型反复遍历、下载 OSS 文件会产生流量、请求费用,需要加调用频次限制
  • 文件大小:大文件不适合直接读取进模型上下文,建议做分片、摘要处理
  • 网络:本地部署的 MCP Server 依赖网络连通阿里云 OSS,内网环境需要配置对应 Endpoint

四、推荐代码结构(以 Python 为例)

  • main.py:MCP 服务入口,工具注册
  • oss_client.py:阿里云 OSS 封装类
  • config.py:存放 endpoint、bucket、ak/sk(优先环境变量,不要硬编码)
  • security.py:参数校验、前缀白名单、调用限流

【相关 FAQ】

问题 1:搭建 OSS MCP Server,让大模型直接调用 OSS,必须用 Python 开发吗?

回答 1:搭建 OSS MCP Server,让大模型直接调用 OSS,不强制 Python,MCP 有 Node、Go 等版本 SDK,你可以根据自己熟悉的技术栈来实现。

问题 2:OSS MCP Server 给大模型调用的时候,AccessKey 怎么保存更安全?

回答 2:OSS MCP Server 给大模型调用时,AccessKey 不要写死在代码里,优先用环境变量、密钥管理服务,搭配 RAM 子账号授予最小 OSS 权限。

问题 3:OSS MCP Server 可以在 Cursor、Claude Desktop 里面接入吗?

回答 3:OSS MCP Server 支持在 Cursor、Claude Desktop 这类支持 MCP 协议的客户端接入,只需要在客户端配置文件填入启动命令即可,让大模型直接调用 OSS。

问题 4:使用 OSS MCP Server,大模型会不会误删 OSS 里面的重要业务文件?

回答 4:使用 OSS MCP Server 存在大模型误删 OSS 文件的风险,开发时可以增加文件前缀白名单、禁用删除工具或者二次确认逻辑,规避风险。

【参考资料】

[2026-11-16](MCP 协议入门:构建自定义 MCP Server 给 AI Agent 调用)阿里云开发者社区

[2026-11-14](阿里云 OSS Python SDK 官方文档)阿里云

[2026-11-10](MCP Inspector 调试 MCP Server 工具教程)Model Context Protocol 官方文档

[2026-11-08](Claude Desktop 接入自定义 MCP Server 实操)掘金

[2026-11-05](RAM 子账号最小权限配置 OSS 访问策略)阿里云文档中心

【免责声明】

本文为 OSS MCP Server 技术实操分享,仅用于技术学习研究;OSS MCP Server 涉及云账号密钥、对象存储读写权限,上线前务必做好权限管控、调用限流与操作审计;不当配置可能造成文件丢失、信息泄露、产生额外云费用;阿里云 OSS 相关计费、权限规则以阿里云官方文档为准;MCP 协议本身还在迭代,接口行为可能随版本更新变化。