百度网盘

功能概述

百度网盘的核心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表示种子。