能力概述
百度网盘核心API现已全面兼容MCP协议。涵盖上传、下载、文件管理、文件搜索等，开发者仅需简单配置即可快速接入百度网盘服务，在AI应用内完成文件上传、下载、管理等能力，大幅降低开发者调用网盘服务门槛，显著提升开发者的开发效率。
使用前准备
- 在正式调用前需完成百度网盘开放平台基础流程，详细流程点击查看
- 百度网盘MCP Server URL：https://mcp-pan.baidu.com/sse?access_token=xx
核心能力
基础文件信息-获取文件列表
- 说明：获取用户网盘中指定目录下的文件列表。返回的文件列表支持排序、分页等操作。
- 输入：
* dir：目录名称，以 / 开头的绝对路径，默认为 /。路径包含中文时需要 UrlEncode 编码 * order：排序字段：默认为 name；time 按修改时间排序；name 表示按文件名称排序 * desc：默认为升序，设置为 1 实现降序 （注：排序的对象是当前目录下所有文件，不是当前分页下的文件） * limit：查询数目，默认为 1000，建议最大不超过 1000 * folder：是否只返回文件夹，0 返回所有，1 只返回文件夹，且属性只返回 path 字段
- 输出：
* list（array）：文件信息列表。包含以下信息：文件类型、文件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。递归是指：当目录下有文件夹，使用此参数，可以获取到## 文件夹下面的文件 * folder：是否只返回文件夹，0 返回所有，1 只返回文件夹，且属性只返回 path 字段
- 输出：
* info（array）：文档列表。包含以下信息：文件类型、文件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 只返回文件夹，且属性只返回 path 字段
- 输出：
* info（array）：图片列表。包含以下信息：文件类型、文件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 只返回文件夹，且属性只返回 path 字段
- 输出：
* info（array）：视频列表。包含以下信息：文件类型、文件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 array）：示例：[{"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 array）：要删除文件的绝对路径，示例：["/test/123456.docx"]
- 输出：
* taskid：异步任务id, 当async=2时返回
文件管理-移动
- 说明：用于对指定的文件进行移动操作。
- 输入：
* async：0 同步，1 自适应，2 异步 * ondup：全局ondup,遇到重复文件的处理策略, fail(默认，直接返回失败)、newcopy(重命名文件)、overwrite、skip * filelist（json array）：示例：[{"path":"/test/123456.docx","dest":"/test/abc","newname":"11223.docx"}] * path：原文件绝对路径 * dest：目标目录 * newname：目标文件名
- 输出：
* taskid：异步任务id, 当async=2时返回 * info（array）：文件信息
文件管理-重命名
- 说明：用于对指定的文件进行重命名操作。
- 输入：
* async：0 同步，1 自适应，2 异步 * ondup：全局ondup,遇到重复文件的处理策略, fail(默认，直接返回失败)、newcopy(重命名文件)、overwrite、skip * filelist（json array）：示例：[{"path":"/test/123456.docx","newname":"123.docx"}] * path：原文件绝对路径 * newname：新文件名
- 输出：
* taskid：异步任务id, 当async=2时返回 * info（array）：文件信息
文件上传
- 说明：用于将用户本地文件上传存储在网盘的云端文件，将用户本地文件上传存储在网盘的云端文件，因需要对本地文件读取，上传工具仅支持stdio模式。
- 输入：
* local_file_path：本地文件路径 * remote_path：（可选参数）网盘存储路径，必须以/开头。如不指定，将默认上传到"/来自：mcp_server"目录下
- 输出：
* filename：文件名 * size：文件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 种子