跳到主要内容

功能说明

🕒 更新时间：2025-05-08
✨ 版本：v1.0.0

简介​

360AI云盘核心API现已全面兼容MCP协议，提供强大的云端文件管理能力。涵盖：

✅ 用户信息管理
✅ 文件信息获取
✅ 文件上传下载
✅ 智能文件管理
✅ 文件链接分享
✅ 高级搜索功能

用户通过简单配置即可快速接入360AI云盘服务，能够在多场景中方便使用自己的云盘资源。

功能介绍​

🛠️ 功能名称📝 功能描述🔍 功能说明
file-list基础文件信息-获取文件列表获取用户云盘中指定目录下的文件列表
make-dir文件管理-创建文件夹创建文件夹
file-share文件管理-分享对指定的文件进行分享操作
file-move文件管理-移动对指定的文件进行移动操作
file-rename文件管理-重命名对指定的文件进行重命名操作
file-search文件搜索获取用户指定目录下，包含指定关键字的文件列表
file-save文件保存通过url或文本信息将文件保存到云盘
file-upload-stdio文件上传(只支持 stdio 方式)将用户本地文件上传存储在云盘
file-download-stdio文件下载(只支持 stdio 方式)将用户存储在云盘的云端文件下载到本地

功能详细说明​

📂 基础文件信息-获取文件列表​

说明：获取用户云盘中指定目录下的文件列表。返回的文件列表支持排序、分页等操作。

输入参数：
  • path：目录名称，以 / 开头的绝对路径，默认为 /。路径包含中文时需要 UrlEncode 编码
  • page：页数（默认为0条）
  • page_size：条数（默认为50条）
  • order：默认为降序，设置为desc 实现降序，设置asc 实现升序 （注：排序的对象是当前目录下所有文件，不是当前分页下的文件）

输出参数：
  • list（array）：文件信息列表。

📁 文件管理-创建文件夹​

说明：创建文件夹。

输入参数：
  • fname：创建的文件夹路径 eg：/这是新建的文件夹/

以下特殊字符不支持： :*?"<>\/|
:    - 冒号
*    - 星号（通配符/注释符号）
?    - 问号（通配符/占位符）
"    - 双引号（字符串标识符）
<    - 左尖括号（标签/比较符）
>    - 右尖括号（标签/比较符）
/    - 正斜杠（路径分隔符）
\    - 反斜杠（转义字符/路径分隔符）
|    - 竖线（管道符/逻辑或）


输出参数：
  • nid：文件在云端的唯一标识ID
  • path：上传后使用的文件绝对路径
  • create_time：文件创建时间
  • modify_time：文件修改时间
  • type：是否目录，0 文件、1 目录

🔗 文件管理-分享​

说明：用于对指定的文件进行分享操作。

输入参数：
  • paths：全路径文件，多个文件用英文竖线分隔 eg：/test/123456.docx

输出参数：
  • task_id：任务id

🔄 文件管理-移动​

说明：用于对指定的文件进行移动操作。

输入参数：
  • src_name 文件原路径，多个路径用竖线隔开 eg：/test/123456.docx
  • new_name：目标路径 eg：/new-dir/

输出参数：
  • nid：nid

✏️ 文件管理-重命名​

说明：用于对指定的文件进行重命名操作。

输入参数：
  • src_name：原路径名称 eg：/test/123456.docx
  • new_name：新名称 eg：/test/newname.docx

输出参数：

⬆️ 文件上传​

说明：用于将用户本地文件上传存储在云盘的云端文件。因需要对本地文件进行读取，上传工具仅支持stdio模式。

输入参数：
  • filePaths：本地文件的完整路径（必填，可以是字符串数组包含多个文件）["/Users/qihoo/Downloads/新版安装.mp4"]
  • uploadPath：（可选参数）云盘存储路径，必须以/开头。如不指定，将默认上传到"/来自：mcp_server"目录下

输出参数：
  • name：文件名(文件在云盘的全路径)
  • size：文件size，单位字节
  • nid：文件nid

⬇️ 文件下载​

说明：用于将用户存储在云盘的云端文件下载到本地。

输入参数：
  • nid：文件nid
  • auto：是否自动下载，true：自动下载，false：不自动下载, 只返回下载地址
  • downloadDir：（可选参数）本地下载路径，必须以/开头。如不指定，将默认下载到用户主目录下的".mcp-downloads"文件夹下

输出参数：
  • downloadUrl：文件下载链接

🔍 文件搜索​

说明：用于获取用户指定目录下，文件名包含指定关键字的文件列表。

输入参数：
  • file_category：文件类型 -1:全部 ， 0：其他 ，1：图片， 2：文档 ，3：音乐 ， 4：视频
  • key：文件搜索关键词

输出参数：
  • list 文件信息列表

💾 文件保存​

说明：通过url保存文件或文本文件(md格式)保存为word文件。

输入参数：
  • url：文件下载地址，url或content必传1个
  • content：文件内容 md格式 ，url或content必传1个
  • upload_path：上传路径，如果不指定默认上传到 /来自:mcp_server

输出参数：
  • upload_path ：文件保存路径
  • size：文件大小，单位B

👤 用户基础信息-获取已鉴权用户信息​

说明：获取用户的基本信息，包括账号、头像地址、会员类型等。

输入参数：无需额外参数

输出参数：
  • name：360AI云盘账号昵称
  • total_size：用户云盘总空间，单位B
  • used_size：用户云盘已用空间,单位B
  • vip_desc：云盘会员类型
  • expire：云盘会员有效期