项目介绍
功能概述
百度网盘的核心API现已完全兼容MCP协议。它涵盖了上传、下载、文件管理、文件搜索等功能。开发者只需进行简单的配置即可快速接入百度网盘服务，在AI应用中实现文件上传、下载和管理，显著降低了调用云存储服务的门槛，并大幅提高了开发效率。
使用前准备
- 在正式调用之前，请在百度网盘开放平台完成基本流程。具体步骤请点击这里。
- 百度网盘MCP服务器URL: https://mcp-pan.baidu.com/sse?access_token=xx
核心功能
基本文件信息 - 获取文件列表
- 描述：获取用户云存储指定目录下的文件列表。返回的文件列表支持排序、分页等。
- 输入：
- 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表示种子。