Baidu Netdisk Knowledge MCP

很多人的百度网盘里都有一堆资料：PDF、课程讲义、收藏文章、项目文档、电子书、笔记、截图、压缩包。文件越存越多，真正要找、要读、要整理时反而很痛苦。

Baidu Netdisk Knowledge MCP 做的事很简单：把百度网盘接到支持 MCP 的 AI 客户端里，让 AI 可以安全地读取你选中的资料，生成摘要、知识点、待办、标签和整理建议。

它适合你，如果你想：

• 让 AI 帮你读百度网盘里的 PDF、文档、笔记和课程资料。

• 从一堆收藏资料里提炼知识点、问题和行动项。

• 把网盘资料整理成类似个人知识库的结构。

• 先看整理计划，再决定要不要移动文件。

• 给不同资料套不同处理规则，比如课程笔记、论文阅读、书籍总结。

它不是普通网盘工具

这个项目不是“上传下载 API 包装”，也不是一个新的网盘客户端。

它更像一个 AI 资料助手接口：

1. 你扫码授权百度网盘。

2. 你让 AI 搜索或浏览资料。

3. 你选择一个或多个文件。

4. AI 读取内容，生成笔记、摘要、分类建议。

5. 如果要整理文件，先给 dry-run 计划，不会直接乱动。

Related MCP server: MCP Google Drive Server

一个典型场景

你可以这样对 AI 说：

帮我在百度网盘里找 MCP 相关资料，选最近几份文档，读一下内容，总结成知识笔记，并建议应该放到哪个文件夹。

AI 会通过这个 MCP：

• 搜索百度网盘文件。

• 返回带编号的文件列表。

• 根据你的选择生成 selectionId。

• 下载并解析选中文件。

• 输出结构化笔记和整理建议。

输出可以包含：

{
  "title": "MCP 入门资料整理",
  "category": "AI",
  "tags": ["MCP", "知识管理"],
  "summary": "这组资料主要介绍 MCP 的工具调用、上下文协议和客户端集成方式。",
  "keyPoints": ["MCP 可以让 AI 调用外部工具", "适合做个人资料库入口"],
  "questions": ["哪些客户端支持 MCP？"],
  "actionItems": ["整理常用 MCP server 清单"],
  "suggestedFolder": "/apps/知识库/AI/MCP"
}

核心功能

内置处理模板

项目内置 5 个 skill：

• knowledge-notes：把零散资料整理成结构化知识笔记。

• course-notes：整理课程资料、概念、作业和复习线索。

• paper-reader：阅读论文，提取问题、方法、结论和证据。

• book-summary：总结书籍、长文和阅读材料。

• cleanup-organizer：生成清理、归档和分类建议。

你也可以自己加 Markdown/YAML skill，不需要改代码。

安全原则

这个项目默认偏保守：

• 不会自动移动或删除你的网盘文件。

• 整理工具只生成 dry-run 计划。

• 删除文件必须显式传 confirm: "DELETE"。

• token 默认保存在用户主目录，不写进项目目录。

• 本地文件访问限制在 BAIDU_LOCAL_ROOT 下。

• 默认只允许在 /apps/<appName> 下做写操作。

适合谁

• 用百度网盘存学习资料、论文、电子书、项目文档的人。

• 想把网盘资料变成 AI 可读知识库的人。

• 想让 Codex、Claude Desktop、ChatGPT 等 MCP 客户端读取网盘资料的人。

• 想做个人知识管理，但不想手动一个个下载、打开、复制的人。

不适合谁

• 想要一个带界面的完整网盘 App。

• 只需要普通上传、下载、同步功能。

• 不想配置百度开放平台应用。

• 不使用支持 MCP 的 AI 客户端。

快速开始

先克隆仓库并安装依赖：

git clone https://github.com/capwitf/baidu-netdisk-knowledge-mcp.git
cd baidu-netdisk-knowledge-mcp
npm install
npm run build

准备百度开放平台配置：

BAIDU_APP_KEY=你的 AppKey
BAIDU_SECRET_KEY=你的 SecretKey

本地启动命令：

node dist/cli.js

MCP 客户端配置

把路径换成你本机的仓库路径：

{
  "mcpServers": {
    "baidu-netdisk-knowledge": {
      "command": "node",
      "args": ["C:/path/to/baidu-netdisk-knowledge-mcp/dist/cli.js"],
      "env": {
        "BAIDU_APP_KEY": "你的 AppKey",
        "BAIDU_SECRET_KEY": "你的 SecretKey",
        "BAIDU_REDIRECT_URI": "oob",
        "BAIDU_LOCAL_ROOT": "C:/path/to/baidu-netdisk-knowledge-mcp"
      }
    }
  }
}

首次授权

1. 打开 百度网盘开放平台，创建应用。

2. 记录应用的 AppKey 和 SecretKey。

3. 在 MCP 客户端里调用 baidu_auth_qrcode。

4. 扫码授权后，把回调得到的 code 传给 baidu_auth_exchange_code。

5. 后续 token 会自动保存和刷新。

常用工作流

搜索资料：

{
  "tool": "baidu_search_selectable_files",
  "args": {
    "key": "MCP",
    "dir": "/apps/知识库",
    "recursion": true
  }
}

按编号选择文件：

{
  "tool": "baidu_select_files",
  "args": {
    "resultId": "res_xxx",
    "select": "1,3,5-9"
  }
}

读取和分析：

{ "tool": "baidu_read_selection", "args": { "selectionId": "sel_xxx" } }
{ "tool": "baidu_analyze_selection", "args": { "selectionId": "sel_xxx" } }
{ "tool": "baidu_run_skill", "args": { "selectionId": "sel_xxx", "skill": "knowledge-notes" } }

生成整理计划：

{
  "tool": "baidu_plan_organize_selection",
  "args": {
    "selectionId": "sel_xxx",
    "targetRoot": "/apps/知识库"
  }
}

baidu_plan_organize_selection 只返回计划，不移动文件。默认 BAIDU_STRICT_APP_PATHS=true 时，targetRoot 必须位于 /apps/<appName> 下。

工具清单

• baidu_auth_status

• baidu_auth_url

• baidu_auth_qrcode_url

• baidu_auth_qrcode

• baidu_auth_exchange_code

• baidu_auth_refresh

• baidu_quota

• baidu_list_files

• baidu_list_all_files

• baidu_search_files

• baidu_search_selectable_files

• baidu_list_selectable_files

• baidu_select_files

• baidu_file_metas

• baidu_read_selection

• baidu_analyze_selection

• baidu_list_skills

• baidu_run_skill

• baidu_plan_organize_selection

• baidu_create_folder

• baidu_rename_file

• baidu_copy_file

• baidu_move_file

• baidu_delete_file

• baidu_upload_file

• baidu_download_file

• baidu_operation_log

自定义 Skill

在 BAIDU_SKILLS_DIR 指向的目录里放 .md、.markdown、.yaml 或 .yml 文件即可。

Markdown 示例：

---
name: my-research-note
description: Research note extractor
category: research
outputSchema: knowledge-note
---

Extract thesis, evidence, questions, and follow-up tasks.

然后用：

• baidu_list_skills 查看可用 skill

• baidu_run_skill 运行指定 skill

配置项

.env.example 里列出了常用配置：

开发

npm run check

这个命令会先运行 TypeScript 编译，再运行 Vitest 测试。

相关关键词

Baidu Netdisk MCP、百度网盘 MCP、百度网盘知识库、AI 知识库、MCP server、个人知识管理、AI 文件整理、Knowledge Base MCP

参考资料

• 百度网盘授权介绍

• 获取文件列表

• 查询文件信息

• 下载

• 上传能力说明

• MCP TypeScript SDK

License

MIT