🔧 百度网盘 MCP Server 开发指南



🎉 官方 MCP Server 已发布

百度网盘官方已发布 MCP Server，可直接使用！

快速使用官方 MCP Server

Claude Code：

# 添加官方 SSE 服务器
claude mcp add --transport sse baidu-pan https://mcp-pan.baidu.com/sse

OpenAI Codex (~/.codex/mcp_servers.json)：

{
  "mcpServers": {
    "baidu-pan": {
      "url": "https://mcp-pan.baidu.com/sse"
    }
  }
}

本地 Stdio 模式（支持上传）：

# 克隆官方仓库
git clone https://github.com/baidu-netdisk/mcp.git
cd baidu-pan-mcp

# 安装依赖
npm install

# 配置凭证
export BAIDU_APP_KEY=your_app_key
export BAIDU_SECRET_KEY=your_secret_key
export BAIDU_ACCESS_TOKEN=your_access_token

# 启动
npm start

官方 MCP Server 提供 18 个 Tools，覆盖文件列表、搜索、管理、上传和分享。

📖 本仓库内容

如果你想自己开发百度网盘 MCP Server，或深入了解 API 细节，本仓库提供完整的开发指南：

🏗️ 自定义开发

为什么要自己开发？

• 🎯 需要定制化功能（如自动同步、批量操作）
• 🔧 需要特殊权限控制
• 📦 需要集成到已有系统
• 🧪 学习 MCP Server 开发

前置条件

安装

git clone https://github.com/XiLeForCLY/baidu-pan-mcp-server.git
cd baidu-pan-mcp-server
npm install
npm run build

配置凭证

export BAIDU_APP_KEY=your_app_key
export BAIDU_SECRET_KEY=your_secret_key
export BAIDU_ACCESS_TOKEN=your_access_token

获取 Access Token

使用项目提供的授权辅助脚本：

node scripts/oauth-helper.mjs
# 浏览器会自动打开，授权后终端显示 Token

详细流程参考 OAuth 授权指南。

注册到 AI 助手

# Claude Code
claude mcp add --transport stdio baidu-pan -- node dist/index.js

# Codex (在 ~/.codex/mcp_servers.json 中添加)

🛠️ MCP Tools 列表

📐 架构图

┌─────────────────┐     MCP (stdio/SSE)  ┌──────────────────┐
│   AI 助手        │◄────────────────────►│  MCP Server      │
│ Claude Code /   │     JSON-RPC 2.0     │  (本项目)         │
│ Codex / Cursor  │                      │                  │
└─────────────────┘                      └────────┬─────────┘
                                                  │
                                                  │ REST API (HTTPS)
                                                  ▼
                                         ┌──────────────────┐
                                         │  百度网盘开放平台   │
                                         │ pan.baidu.com    │
                                         │ openapi.baidu.com│
                                         └──────────────────┘

📊 百度网盘 API 速查

详细参数和响应请参考 API 参考文档。

🔗 相关资源

📄 License

MIT License © 2026