connector-baidu-netdisk

name	connector-baidu-netdisk
description	百度网盘文件管理与智能检索。支持浏览、关键词和语义搜索、文件整理、分享链接、容量查询，以及保存文本内容或通过 URL 转存文件。触发关键词：百度网盘、网盘、baidu、netdisk、云盘、文件分享。
description_zh	百度网盘文件管理与智能检索。支持浏览、关键词和语义搜索、文件整理、分享链接、容量查询，以及保存文本内容或通过 URL 转存文件。触发关键词：百度网盘、网盘、云盘、文件分享。
description_en	Baidu Netdisk file management and intelligent search. Supports browsing, keyword and semantic search, file organization, share links, storage usage queries, saving text content, and transferring files from URLs. Trigger keywords: baidu, netdisk, cloud drive, file sharing.
version	1.2.0

百度网盘

通过百度网盘 MCP 浏览、检索和管理用户的云端文件。当前能力包括目录与分类浏览、关键词与语义检索、文件元信息和容量查询、文件整理、创建分享链接，以及保存文本内容或通过 URL 转存文件。

能力边界

当前连接器支持：

• 浏览指定目录下的全部文件，或按文档、图片、视频分类查看。
• 按文件名关键词搜索。
• 使用自然语言进行语义检索，并可按目录、文件类型、扩展名和结果数量筛选。
• 在文件名、图片 OCR 文字、文档正文中搜索关键词。
• 对图片以及文档、视频、音频内容进行语义检索。
• 查询文件元信息、用户基本信息和网盘空间使用情况。
• 新建文件夹，复制、移动和重命名文件。
• 为一个或多个文件创建带有效期和提取码的分享链接。
• 将文本内容保存为网盘文件，单次文本不超过 2 万字。
• 通过可直接下载的 URL 将文件转存到网盘。

当前工具集中未提供：

• 将网盘文件或文件夹下载到本地。
• 直接上传用户设备上的任意本地文件。
• 删除网盘文件或文件夹。
• 将分享链接直接发送给某个联系人；连接器只能创建分享链接，由用户自行发送。

不要把“文本内容保存”或“URL 转存”描述为完整的本地文件上传能力，也不要承诺下载或删除操作。

调用原则

• 涉及百度网盘时，优先使用本连接器提供的 MCP 工具，不要用本地文件系统命令代替网盘操作。
• 目标文件、目录或路径不明确时，先浏览或搜索，再执行后续操作。
• 执行新建、复制、移动、重命名、上传、转存或创建分享链接等写操作前，确认目标对象、目标目录、文件名及冲突处理方式。
• 移动、重命名和覆盖可能改变用户现有文件结构；未获得明确授权时，不使用覆盖策略。
• 用户只要求查找或查看时，保持只读，不顺带执行整理、分享或上传操作。
• 工具要求绝对路径时使用以 / 开头的网盘路径；路径含中文时，按工具参数说明进行 URL 编码。
• 搜索结果可能较多时使用分页或限制返回数量，并向用户说明结果范围。

工具选择

浏览与查询

• 查看目录内容：使用通用文件列表。
• 只查看文档、图片或视频：使用对应的分类列表。
• 查询文件详情：先从列表或搜索结果取得文件 ID，再查询元信息；单次最多查询 10 个文件 ID。
• 查询网盘容量：使用空间配额查询。
• 查询账号基础信息：使用用户信息查询。

搜索

• 用户给出明确文件名关键词时，优先使用文件名关键词搜索。
• 用户使用自然语言描述内容、主题、场景、时间或地点时，优先使用语义检索。
• 用户要求搜索图片中的文字时，选择图片 OCR 搜索来源。
• 用户要求搜索文档正文时，选择文档内容搜索来源。
• 用户要求按画面、音视频内容或文档含义搜索时，选择对应的语义向量搜索来源。
• 用户指定文件类型或后缀时，同时设置分类或扩展名过滤条件，减少无关结果。

文件管理

• 新建文件夹前确认完整目标路径；同名冲突时，除非用户另有要求，优先采用自动重命名而非覆盖。
• 复制、移动和重命名时，先确认源文件绝对路径、目标目录和目标名称。
• 遇到同名文件时，向用户说明可选策略：失败、生成副本名、覆盖或跳过。默认优先选择生成副本名，避免覆盖已有文件。

分享

• 创建分享链接前确认待分享文件、有效期、4 位提取码和备注。
• 提取码只能由数字和小写字母组成，长度为 4 位。
• 创建成功后向用户返回分享链接、有效期和提取码，但不要声称已发送给任何联系人。

保存内容与 URL 转存

• 用户要求把一段文字、会议纪要或生成内容保存到网盘时，使用文本内容上传；单次内容不超过 2 万字。
• 用户未指定目录时，工具默认保存到 /来自：mcp_server；执行前应告知用户默认位置，或询问其期望目录。
• 用户未指定文件名时，工具可能默认保存为 DOCX；为减少歧义，优先确认文件名和扩展名。
• 用户提供可直接下载的文件链接并要求保存到网盘时，使用 URL 转存。
• URL 不是直接下载地址、需要登录或访问受限时，不保证转存成功，应向用户说明限制。
• 不要尝试用文本上传接口读取或上传任意本地二进制文件。

使用示例

• 查看我百度网盘根目录下的文件，并告诉我还剩多少可用空间。
• 列出「项目资料」文件夹里的所有文档。
• 从文件名、文档正文和图片文字中搜索与「项目合同」相关的文件。
• 找出网盘里与海边日落相关的图片和视频。
• 搜索最近整理的 AIGC 研究资料，只返回 PDF 和 DOCX 文件。
• 新建一个「AIGC 调研资料」文件夹，把相关文件复制进去。
• 把「旧项目/周报.docx」移动到「归档/2026」，遇到同名文件时跳过。
• 将「最终方案-v3.docx」重命名为「最终方案.docx」。
• 为「周报.docx」创建一个有效期 7 天、带 4 位提取码的分享链接。
• 把这段会议纪要以「产品会议纪要.docx」保存到百度网盘的「会议记录」文件夹。
• 把这个可下载链接中的文件转存到百度网盘的「参考资料」文件夹。

错误处理

• 认证失败：当返回 HTTP 401/403、Access Token 无效或过期等错误时，提示用户在连接器管理中重新连接百度网盘；如需重新获取凭据，可参考百度网盘开放平台文档：https://pan.baidu.com/union/doc/Wm9sl0i0j。
• 路径错误：确认路径以 / 开头，并按工具要求对包含中文的路径进行 URL 编码。
• 文件不存在：先重新浏览父目录或搜索文件名，避免基于猜测继续执行。
• 同名冲突：不要擅自覆盖，向用户说明冲突并确认使用生成副本名、覆盖、跳过或失败策略。
• 分享失败：检查文件 ID、有效期和提取码格式；文件 ID 列表必须符合工具要求的严格 JSON 字符串格式。
• 转存失败：检查 URL 是否可公开访问并可直接下载；若链接需要登录、验证码或临时授权，告知用户当前接口可能无法转存。
• 语义检索无结果：尝试缩短描述、调整搜索来源、取消过窄的文件类型限制，或退回文件名关键词搜索。

安全说明

• Access Token 由连接器管理，通过 MCP 连接参数传递。
• 禁止在对话、日志或输出文件中展示完整的 Access Token。
• 未经用户明确确认，不覆盖已有文件，不移动或重命名重要文件，不创建公开分享链接。
• 分享链接、提取码和文件路径可能包含敏感信息，只向当前用户展示，不主动传播给第三方。