返回市场
百度网盘

百度网盘

作者:Baidu Netdisk99900 星标更新:2025-04-23

项目介绍

功能概述

百度网盘的核心API现已完全兼容MCP协议。它涵盖了上传、下载、文件管理、文件搜索等功能。开发者只需进行简单的配置即可快速接入百度网盘服务,在AI应用中实现文件上传、下载和管理,显著降低了调用云存储服务的门槛,并大幅提高了开发效率。

使用前准备

核心功能

基本文件信息 - 获取文件列表

  • 描述:获取用户云存储指定目录下的文件列表。返回的文件列表支持排序、分页等。
  • 输入:
  • dir: 目录名称,以/开头的绝对路径,默认为/。包含中文字符的路径需要进行UrlEncode编码。
  • order: 排序字段:默认为name;time按修改时间排序;name按文件名排序。
  • desc: 默认为升序;设置为1为降序(注意:排序适用于当前目录下所有文件,而不仅仅是当前页面)。
  • limit: 查询条数,默认为1000,建议最大值为1000。
  • folder: 是否仅返回文件夹。0表示返回所有;1表示仅返回文件夹,且属性中只包含路径字段。
  • 输出:
  • list (数组):文件信息列表。包括:文件类型、文件fs_id(云中的唯一标识符)、是否为目录、客户端创建时间、服务器创建和修改时间、云哈希值(非实际文件md5)、文件大小、缩略图URL。

基本文件信息 - 获取文档列表

  • 描述:获取用户云存储指定目录下的文档列表。
  • 输入:
  • parent_path: 目录名称,以/开头的绝对路径,默认为/。包含中文字符的路径需要进行UrlEncode编码。
  • page: 分页页码,从1开始。如果未指定,则以不分页模式返回所有结果。如果指定了page参数,则按修改时间降序排列结果。
  • num: 每页文档数量,默认为1000,建议最大值为1000。
  • order: 排序字段:time按修改时间排序,name按文件名排序,size按文件大小排序,默认为time。
  • desc: 0为升序,1为降序,默认为1。
  • recursion: 是否需要递归。0表示不需要,1表示需要,默认为0。递归意味着:当目录包含子文件夹时,此参数允许检索这些子文件夹下的文件。
  • folder: 是否仅返回文件夹。0表示返回所有;1表示仅返回文件夹,且属性中只包含路径字段。
  • 输出:
  • info (数组):文档列表。包括:文件类型、文件fs_id(云中的唯一标识符)、是否为目录、客户端创建时间、服务器创建和修改时间、云哈希值(非实际文件md5)、文件大小。

基本文件信息 - 获取图片列表

  • 描述:获取用户云存储指定目录下的图片列表。
  • 输入:
  • parent_path: 目录名称,以/开头的绝对路径,默认为/。包含中文字符的路径需要进行UrlEncode编码。
  • page: 分页页码,从1开始。如果未指定,则以不分页模式返回所有结果。如果指定了page参数,则按修改时间降序排列结果。
  • num: 每页文档数量,默认为1000,建议最大值为1000。
  • order: 排序字段:time按修改时间排序,name按文件名排序,size按文件大小排序,默认为time。
  • desc: 0为升序,1为降序,默认为1。
  • recursion: 是否需要递归。0表示不需要,1表示需要,默认为0。递归意味着:当目录包含子文件夹时,此参数允许检索这些子文件夹下的文件。
  • web: 如果web为1,则返回图片缩略图。
  • folder: 是否仅返回文件夹。0表示返回所有;1表示仅返回文件夹,且属性中只包含路径字段。
  • 输出:
  • info (数组):图片列表。包括:文件类型、文件fs_id(云中的唯一标识符)、是否为目录、客户端创建时间、服务器创建和修改时间、云哈希值(非实际文件md5)、文件大小、缩略图(三种尺寸)。

基本文件信息 - 获取视频列表

  • 描述:获取用户云存储指定目录下的视频列表。
  • 输入:
  • parent_path: 目录名称,以/开头的绝对路径,默认为/。包含中文字符的路径需要进行UrlEncode编码。
  • page: 分页页码,从1开始。如果未指定,则以不分页模式返回所有结果。如果指定了page参数,则按修改时间降序排列结果。
  • num: 每页文档数量,默认为1000,建议最大值为1000。
  • order: 排序字段:time按修改时间排序,name按文件名排序,size按文件大小排序,默认为time。
  • desc: 0为升序,1为降序,默认为1。
  • recursion: 是否需要递归。0表示不需要,1表示需要,默认为0。递归意味着:当目录包含子文件夹时,此参数允许检索这些子文件夹下的文件。
  • web: 如果web为1,则返回视频预览缩略图。
  • folder: 是否仅返回文件夹。0表示返回所有;1表示仅返回文件夹,且属性中只包含路径字段。
  • 输出:
  • info (数组):视频列表。包括:文件类型、文件fs_id(云中的唯一标识符)、是否为目录、客户端创建时间、服务器创建和修改时间、云哈希值(非实际文件md5)、文件大小、缩略图(三种尺寸)。

文件管理 - 创建文件夹

  • 描述:创建文件夹。
  • 输入:
  • path: 待创建文件夹的路径。
  • 输出:
  • fs_id: 文件在云中的唯一标识ID。
  • category: 分类类型,6表示文件夹。
  • path: 文件上传后的绝对路径。
  • ctime: 文件创建时间。
  • mtime: 文件修改时间。
  • isdir: 是否为目录。0表示文件,1表示目录。

文件管理 - 复制

  • 描述:复制指定文件。
  • 输入:
  • async: 0表示同步,1表示自适应,2表示异步。
  • ondup: 全局ondup,处理重复文件策略:fail(默认,直接返回失败),newcopy(重命名文件),overwrite,skip。
  • filelist (json数组):示例:[{"path":"/test/123456.docx","dest":"/test/abc","newname":"11223.docx"}]
  • path: 源文件的绝对路径。
  • dest: 目标目录。
  • newname: 目标文件名。
  • 输出:
  • taskid: 异步任务ID,当async=2时返回。

文件管理 - 删除

  • 描述:删除指定文件。
  • 输入:
  • async: 0表示同步,1表示自适应,2表示异步。
  • ondup: 全局ondup,处理重复文件策略:fail(默认,直接返回失败),newcopy(重命名文件),overwrite,skip。
  • filelist (json数组):待删除文件的绝对路径。示例:["/test/123456.docx"]
  • 输出:
  • taskid: 异步任务ID,当async=2时返回。

文件管理 - 移动

  • 描述:移动指定文件。
  • 输入:
  • async: 0表示同步,1表示自适应,2表示异步。
  • ondup: 全局ondup,处理重复文件策略:fail(默认,直接返回失败),newcopy(重命名文件),overwrite,skip。
  • filelist (json数组):示例:[{"path":"/test/123456.docx","dest":"/test/abc","newname":"11223.docx"}]
  • path: 源文件的绝对路径。
  • dest: 目标目录。
  • newname: 目标文件名。
  • 输出:
  • taskid: 异步任务ID,当async=2时返回。
  • info (数组):文件信息。

文件管理 - 重命名

  • 描述:重命名指定文件。
  • 输入:
  • async: 0表示同步,1表示自适应,2表示异步。
  • ondup: 全局ondup,处理重复文件策略:fail(默认,直接返回失败),newcopy(重命名文件),overwrite,skip。
  • filelist (json数组):示例:[{"path":"/test/123456.docx","newname":"123.docx"}]
  • path: 源文件的绝对路径。
  • newname: 新文件名。
  • 输出:
  • taskid: 异步任务ID,当async=2时返回。
  • info (数组):文件信息。

文件上传

  • 描述:将本地文件上传到百度网盘的云存储。由于需要读取本地文件,上传工具仅支持stdio模式。
  • 输入:
  • local_file_path: 本地文件路径。
  • remote_path: (可选)云存储路径,必须以/开头。如果没有指定,默认上传至“/来自:mcp_server”目录。
  • 输出:
  • filename: 文件名。
  • size: 文件大小(字节)。
  • remote_path: 文件在云存储中的路径。
  • fs_id: 文件fsid。
  • status: 上传状态:success表示成功,error表示失败。
  • message: 提示信息。

文件下载

  • 描述:将存储在百度网盘云存储中的文件下载到本地设备。
  • 输入:
  • fsid: 文件fsid。
  • 输出:
  • dlink: 文件下载链接。

文件搜索

  • 描述:获取用户云存储指定目录下文件名包含指定关键词的文件列表。
  • 输入:
  • key: 文件搜索关键词。
  • 输出:
  • list: 文件信息列表。
  • fsid: 文件ID。
  • path: 文件路径。
  • server_filename: 文件名。
  • size: 文件大小(字节)。
  • isdir: 是否为目录。1表示目录,0表示非目录。
  • md5: 文件md5。
  • category: 文件类型:1表示视频,2表示音乐,3表示图片,4表示文档,5表示应用,6表示其他,7表示种子。
百度网盘 - MCP 市场 - 星战科技