百度网盘 - MCP服务，MCP服务器，MCP教程

能力概述

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