跳到主要内容

功能说明

🕒 更新时间：2026-03-31
✨ 版本：v1.0.0

简介​

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

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

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

功能介绍​

🛠️ 功能名称📝 功能描述🔍 功能说明
file-list基础文件信息-获取文件列表获取用户云盘中指定目录下的文件列表
make-dir文件管理-创建文件夹创建文件夹
file-share文件管理-分享对指定的文件进行分享操作
file-move文件管理-移动对指定的文件进行移动操作
file-rename文件管理-重命名对指定的文件进行重命名操作
file-del文件管理-删除删除云盘中的文件或文件夹
file-search文件搜索获取用户指定目录下，包含指定关键字的文件列表
file-save文件保存通过 URL 或文本信息将文件保存到云盘，支持多 URL 批量保存和同名文件处理策略
file-append-content文件追加向云盘中已有的文本文件末尾追加内容
detect-file-exists文件重名检测检测目标目录下是否存在同名文件（按文件名和文件大小匹配）
file-trans-or-copy文件转移/复制将一个或多个文件转移或复制到目标目录，支持同名覆盖策略
get-node-info-by-nid节点信息查询根据单个 nid 获取文件夹（知识库）节点信息，可选返回 ks_info
filedir-count-origin-size目录原始大小统计获取该目录下所有文件和文件夹（递归）的原始大小
file-clear-dir清空目录删除目录下文件并保留原目录（直接删除不进回收站）
get-config配置文件操作支持 INI/JSON/YAML 的 get/set/delete/list/read/write 配置操作
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

输出参数：

🗑️ 文件管理-删除​

说明：删除云盘中的文件或文件夹，支持批量删除。

输入参数：
  • src_name：要删除的文件或文件夹路径，多个路径用英文竖线(|)分隔 eg：/test/123456.docx 或 /test/a.txt|/test/b.txt

输出参数：
  • data：删除结果，true 表示成功

⬆️ 文件上传​

说明：用于将用户本地文件上传存储在云盘的云端文件。因需要对本地文件进行读取，上传工具仅支持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

📝 文件追加​

说明：向云盘中已有的文本文件末尾追加内容。

输入参数：
  • path：文件完整路径，必须以 / 开头，例如 /test/test.txt
  • content：要追加到文件末尾的文本内容

输出参数：
  • status：操作状态（success）

🧾 文件重名检测​

说明：检测目标目录下是否存在同名文件（按文件名和文件大小匹配），常用于上传前预检。

输入参数：
  • path：目标目录路径，必须以 / 开头，例如 /AI为我下载/20260331/
  • files：待检测文件列表（数组），每项包含：
      - fname：文件名
      - fsize：文件大小（字节）
    示例：[{"fname":"文件名1","fsize":632},{"fname":"文件名2","fsize":2859}]

输出参数：
  • data.node_list：已存在的重名文件列表（若无重名则为空数组）

🔁 文件转移/复制​

说明：将一个或多个文件转移或复制到目标目录，支持同名重命名或覆盖策略。

输入参数：
  • src_name：源文件完整路径，多个路径用英文竖线(|)分隔
  • new_path：目标目录路径
  • is_delete：是否删除源文件（1=删除，表示转移；0=不删除，表示复制）
  • is_replace：（可选）同名处理策略（0=重命名，1=覆盖）
  • src_ks_id：（可选）源文件所在群组 ks_id（不参与 sign）
  • new_ks_id：（可选）目标目录所在群组 ks_id（不参与 sign）

输出参数：
  • data：键值映射，key 为原文件 nid，value 为目标目录下新文件 nid

🧩 节点信息查询（按 nid）​

说明：根据单个 nid 获取文件夹（知识库）节点信息；可通过 ks_ext 控制是否返回 ks_info。

输入参数：
  • nid：节点 nid（仅支持文件夹/知识库）
  • ks_ext：（可选）是否返回 ks_info，1=返回，0=不返回（默认 0）

输出参数：
  • data：节点信息对象（当 ks_ext=1 时可包含 ks_info）

📏 目录原始大小统计​

说明：获取指定目录下所有文件和文件夹（递归）的原始大小。

输入参数：
  • path：目录完整路径

输出参数：
  • data.size：目录递归原始大小（字节）

🧹 清空目录​

说明：删除目录下文件，保留原目录；直接删除，不进入回收站。

输入参数：
  • fname：目录路径，多个路径用英文竖线(|)分隔

输出参数：
  • data：目录节点信息（清理后的目录对象）

⚙️ 配置文件操作​

说明：支持 INI/JSON/YAML 配置文件的键值与子项操作，包含 get/set/delete/list/read/write 六类命令。

输入参数：
  • path：配置文件路径（必须以 / 开头）
  • command：操作命令，支持 config:get/config:set/config:delete/config:list/config:read/config:write
  • type：配置文件类型，支持 ini/json/yaml/yml
  • key：（可选）键路径，如 app.debug
  • value：（可选）写入值（set 场景）
  • content：（可选）完整文件内容（write 场景）

输出参数：
  • data：按 command 返回对应结果（value/keys/config/status 等）

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

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

输入参数：无需额外参数

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