360 AI 云盘 MCP Server & CLI
360 AI 云盘的 MCP Server + CLI 工具,为 AI Agent 和开发者提供云盘文件管理能力。基于 TypeScript / Node.js 构建,包含两个产物:
- 360 AI 云盘 CLI — 面向终端用户和 AI Agent(通过 Shell)的命令行工具,命令名
360disk,结构化 JSON 输出。 - 360 AI 云盘 MCP Server — 面向支持 Model Context Protocol (MCP) 的 AI Agent(如 Claude Desktop、Cursor)的服务端,支持 Stdio / Streamable HTTP / SSE 三种传输方式。
快速开始
npm install # 安装依赖
npm run build # 构建
MCP Server
在 MCP Client 配置文件中添加(适用于 Cursor、Claude Desktop 等):
{
"mcpServers": {
"360-ai-cloud-disk-mcp": {
"command": "node",
"args": ["build/index.js", "--stdio"],
"env": {
"API_KEY": "yunpan_xxxxxxxxxx"
}
}
}
}
其他传输方式:
node build/index.js --stdio # stdio 模式
node build/index.js --sse # SSE 模式
node build/index.js --http # Streamable HTTP 模式
MCP 工具
CLI
node build/cli.js --help
# 登录
node build/cli.js auth login --api-key yunpan_xxxxxxxxxx
# 常用操作
node build/cli.js dir ls / # 列出目录
node build/cli.js file search "报告" # 搜索文件
node build/cli.js file upload ./report.pdf --dest /文档/ # 上传文件
node build/cli.js file download <nid> --dir ./ # 下载文件
node build/cli.js file share /文档/报告.pdf # 分享文件
CLI 命令
CLI 特性
- 结构化输出:默认 JSON,支持
--format text和--quiet模式 - 统一错误码:语义化错误码,进程退出码对应
- 管道集成:stdin 输入、批量操作,可与
jq等工具组合 - 超时/重试:
--timeout和--retries全局选项 - Shell 补全:bash / zsh 自动补全
认证
使用前需要 360 AI 云盘 API 密钥(yunpan_ 开头)。
鉴权优先级:--api-key 参数 > API_KEY 环境变量 > ~/.360disk/config.json
环境变量
许可证
Apache-2.0