Which integrations are available for this server?

Provides tools for managing Baidu Netdisk (百度网盘) files, including listing, searching, uploading, downloading, sharing, and file operations through the Baidu Open API.

How do I use baidu-pan-mcp-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@baidu-pan-mcp-server 列出我的网盘根目录文件" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

🔧 百度网盘 MCP Server 开发指南

基于百度网盘开放 API 的 Model Context Protocol 服务器开发全攻略

License: MIT MCP

🎉 官方 MCP Server 已发布

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

项目	链接
GitHub 仓库	baidu-netdisk/mcp ⭐47
在线 SSE	`https://mcp-pan.baidu.com/sse`
文档	百度网盘 MCP 官方文档

快速使用官方 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 细节，本仓库提供完整的开发指南：

文档	内容
API 参考	百度网盘完整 REST API 文档，含所有端点、参数和响应
OAuth 授权指南	OAuth 2.0 授权码流程详解，含自动授权脚本
MCP 开发指南	从零开发 MCP Server 的完整教程
参考实现	TypeScript 参考代码（12 个 MCP Tools）

🏗️ 自定义开发

为什么要自己开发？

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

前置条件

依赖	说明
百度开放平台应用	openapi.baidu.com 创建
Node.js 18+	运行环境
AI 编程助手	Claude Code 或 OpenAI Codex

安装

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 列表

Tool	功能	示例提示词
`list_files`	列出目录文件	"列出网盘根目录的文件"
`search_files`	搜索文件	"搜索包含 report 的文件"
`get_file_info`	获取文件详情	"查看文件 ID 12345 的信息"
`download_file`	获取下载链接	"获取文件下载链接"
`create_folder`	创建文件夹	"创建文件夹 /项目备份"
`rename_file`	重命名	"把 old.txt 改名为 new.txt"
`move_files`	移动文件	"把 report.pdf 移到 /归档/"
`copy_files`	复制文件	"复制 config.json 到 /备份/"
`delete_files`	删除文件	"删除 /temp/ 下所有文件"
`get_user_info`	用户信息	"查看网盘账号信息"
`get_quota`	存储配额	"网盘还剩多少空间？"
`create_share`	创建分享	"分享 file.txt 提取码 1234"

📐 架构图

┌─────────────────┐     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	端点	方法
用户信息	`/rest/2.0/xpan/nas?method=uinfo`	GET
配额查询	`/api/quota`	GET
文件列表	`/rest/2.0/xpan/file?method=list`	GET
文件搜索	`/rest/2.0/xpan/file?method=search`	GET
文件元信息	`/rest/2.0/xpan/multimedia?method=filemetas`	GET
创建文件夹	`/rest/2.0/xpan/file?method=create`	POST
文件管理	`/rest/2.0/xpan/file?method=filemanager`	POST
秒传	`/rest/2.0/xpan/file?method=rapidupload`	POST
预上传	`/rest/2.0/xpan/file?method=precreate`	POST
上传分片	`/rest/2.0/xpan/file?method=upload`	POST
合并文件	`/rest/2.0/xpan/file?method=create`	POST
创建分享	`/rest/2.0/xpan/share?method=rapidshare`	POST

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

🔗 相关资源

资源	链接
百度网盘官方 MCP	baidu-netdisk/mcp
百度网盘开放平台文档	pan.baidu.com/union/doc/
百度开放平台	openapi.baidu.com
MCP 协议规范	modelcontextprotocol.io
MCP SDK (TypeScript)	@modelcontextprotocol/sdk
bypy (Python 客户端)	houtianze/bypy ⭐8.5k

baidu-pan-mcp-server