“

本文想回答的核心问题：
“百度网盘 MCP Server 到底能干什么？作为开发者或个人用户，我怎样在 10 分钟内把它接入 Claude/Cursor，完成上传、搜索、分享、管理等一整套自动化操作？”

1. 先给结论：一张图看清全部能力

场景 一句话能力 适合谁
文件上传 本地/URL/文本 三种方式直传网盘，自动生成目录 内容创作者、备份脚本
文件管理 增删改查、复制移动、批量重命名 运维、知识库管理员
语义搜索 用“人话”找文件，不用死记文件名 律师、学者、设计师
快速分享 一行命令生成带密码的短链 社群运营、外包协作
容量监控 实时查剩余空间，7 天到期提醒 所有用户

2. 10 分钟上手：从 0 到发出第一条指令

2.1 准备材料清单

  1. 百度账号（已通过实名认证）
  2. Access Token（个人体验版 2 分钟获取，企业版需走审核）
  3. 支持 MCP 的客户端：Cursor ≥ 0.40 或 Claude Desktop
  4. 可选：Python 3.11+（只有做“本地文件上传”才需要）

2.2 拿到 Access Token（个人体验通道）

点击 → 授权链接
浏览器回跳地址栏会出现 https://openapi.baidu.com/oauth/#access_token=xxxxxxxxxx&expires_in=...
复制 xxxxxxxxxx 部分，环境变量里记为 BAIDU_NETDISK_ACCESS_TOKEN。

“

作者反思：第一次用的时候嫌跳转麻烦，其实整个流程比拍一张自拍还快；企业版虽然要填表，但换来的 QPS 和容量更稳。

2.3 Cursor 最快配置（SSE 模式，无上传）

打开 Cursor → Settings → MCP → Add Server
粘贴下方 JSON，保存后看到绿灯即为成功。

{
  "mcpServers": {
    "baidu-netdisk": {
      "url": "https://mcp-pan.baidu.com/sse?access_token=你的xxxxxxxxxx"
    }
  }
}

2.4 验证：让 AI 帮你查剩余空间

在 Agent 模式输入：
“Check my netdisk quota.”
返回示例：

total: 2TB, used: 534GB, free: 1.46TB, expire_soon: false

绿灯 + 数字 = 接入成功。

3. 三大高频场景实战

3.1 场景 A：把“散落的截图”自动归到 /项目素材/截图归档

步骤

  1. 本地目录 ~/Desktop/shots 里有 200 张 PNG。
  2. 打开 Cursor，Agent 模式输入：
    “Create folder /项目素材/截图归档 and upload all PNG files from ~/Desktop/shots to it.”
  3. 若使用 SSE 模式，会提示“上传不可用”；切到 Python stdio 模式即可。
  4. 完成后返回每文件的 fs_id、remote_path、size。

“

作者反思：以前每月手动拖一次，现在一条自然语言就解决；最惊喜的是自动生成 docx 摘要，方便后续全文检索。

3.2 场景 B：用“人话”找回半年前那个“蓝色图标的原型稿”

输入：
“Find the blue icon prototype file I uploaded around March this year.”
语义搜索返回：

filename: blue-icon-v1.2.sketch  
path: /设计/2024Q1/blue-icon-v1.2.sketch  
size: 3.1MB  
abstract: 包含 64px、128px、256px 三版蓝色图标，配色 #0052D9

无需记住任何关键词，直接下载或分享即可。

3.3 场景 C：批量生成分享链接并写进 Notion 数据库

需求：给 /合同/2024/ 下 10 个 PDF 各自创建 7 天有效、密码统一的分享链。
指令：
“Batch share all PDFs under /合同/2024/, set password qwer, period 7 days, and give me Markdown table with filename, link, pwd.”
返回：

filename share_link pwd
NDA-客户A.pdf https://pan.baidu.com/s/1sxYxxxxx qwer
采购-客户B.pdf https://pan.baidu.com/s/1sxYxxxy qwer
… … …

复制即可粘贴到 Notion，全程 30 秒。

4. 技术深潜：接口原语与组合打法

4.1 目录与文件原子操作

原语 典型参数 同步/异步 常见组合
make_dir path, rtype=1 同步 上传前保证目录存在
file_copy filelist=[{path,dest,newname}], async=1 自适应 模板式复制、快速备份
file_move 同上 自适应 项目结项归档
file_del filelist=[“/tmp/a.txt”] 自适应 清理 CI 构建包
file_rename filelist=[{path,newname}] 自适应 版本号统一加前缀

“

作者反思：async=2 适合一次性千级文件，但需额外轮询 taskid；小批量用同步模式反而更快。

4.2 三种上传方式对比

方式 优点 局限 最佳场景
本地文件上传 支持超大文件、断点续传 仅 stdio 模式 备份 NAS、照片原片
URL 上传 云端拉取，不占本地带宽 需可公开下载链接 抓包第三方资源
文本上传 即时生成 docx/txt 2 万字上限 会议纪要、代码片段

4.3 搜索：关键词 vs 语义

  • 关键词搜索（file_keyword_search）
    适合“我知道大概文件名”——快、精准、支持分页。
  • 语义搜索（file_semantics_search）
    适合“我只记得内容”——支持自然语言、返回摘要与缩略图，代价是耗时多 200~400ms。

5. 常见“坑”与自救指南

坑 现象 自救
中文路径未 URL Encode 报 400 “path invalid” 提前 encode，斜杠也要转 %2F
个人 token 失效 返回 111 重新走体验授权链接即可
批量分享含文件夹 接口只接受 fs_id 列表 先用 file_list 遍历取出 fs_id 再调用分享
SSE 模式上传 提示工具不存在 切 stdio，或用 URL 上传中转

6. 实用摘要 / 一页速览

  1. 获取 Access Token → 填到 Cursor 的 mcp.json → 绿灯即成功。
  2. 文件上传只有 Python stdio 能做；其余查询/管理 SSE 足够。
  3. 目录路径含中文先 URL Encode；批量操作一律用 filelist JSON。
  4. 语义搜索是“懒人救星”，但关键词搜索更快；二者可叠加使用。
  5. 分享链默认 7 天、密码 1234；可批量、可自定义。
  6. 容量接口带“7 天内到期”标志，适合写定时告警脚本。

7. 常见问答 FAQ

  1. 个人体验 Token 会突然失效吗？
    会。官方不定期刷新，建议把获取链接收藏，失效 30 秒即可重新拉新。

  2. 能否上传文件夹？
    接口层面只认“文件”；需本地递归后逐文件调上传，再按需 make_dir。

  3. 支持断点续传吗？
    本地文件上传模式自带；URL/文本上传不支持。

  4. 语义搜索对英文文件名友好吗？
    实测中英文混合无差别，但用“蓝色图标”比“blue icon”更容易匹配中文摘要。

  5. 可以设置永久分享吗？
    目前最大 36500 天（≈100 年），设 0 代表永久；企业账号才开放。

  6. async=2 的 taskid 如何轮询？
    官方暂未开放 task 查询接口，建议小批量同步，或记录 taskid 等待后续文档。

  7. Cursor 显示红灯但 URL 没错？
    检查 Token 是否带空格；若仍失败，用 curl 直接测 /user_info 看是否 401。