Skip to main content
Glama
XiLeForCLY

baidu-pan-mcp-server

by XiLeForCLY



🔧 百度网盘 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,覆盖文件列表、搜索、管理、上传和分享。


Related MCP server: AI-Persona

📖 本仓库内容

如果你想自己开发百度网盘 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


📄 License

MIT License © 2026

Related MCP Connectors

Related MCP Servers

  • F
    license
    C
    quality
    D
    maintenance
    A Model Context Protocol server that enables Claude Desktop to generate images using Baidu's iRAG image generation API through a standardized interface.
    1
    -
  • A
    license
    B
    quality
    D
    maintenance
    An MCP protocol server that supports multi-AI personality summoning and collaboration, which can be used for intelligent collaboration in multiple scenarios such as code analysis and product design.
    4
    1
    Apache 2.0
  • A
    license
    B
    quality
    D
    maintenance
    MCP server for Nutstore cloud storage, enabling AI assistants to manage files via WebDAV with support for listing, searching, uploading, downloading, and more.
    19
    23 PyPI
    1
    MIT