360 AI 云盘 MCP Server & CLI

360 AI 云盘的 MCP Server + CLI 工具，为 AI Agent 和开发者提供完整的云盘文件管理能力。

• MCP Server — 标准 MCP 协议接入，支持 Stdio / Streamable HTTP / SSE
• 360disk CLI — 18 个命令覆盖云盘全部操作，结构化 JSON 输出
• Skills 技能库 — 开箱即用的 AI Agent 技能，节省 75%+ Token

快速开始

安装

npm install -g @aicloud360/mcp-server-disk

MCP Server 接入

Stdio 方式

在 MCP Client 配置文件中添加（适用于 Cursor、Claude Desktop 等）：

{
  "mcpServers": {
    "360-ai-cloud-disk": {
      "command": "npx",
      "args": ["-y", "@aicloud360/mcp-server-disk", "--stdio"],
      "env": {
        "API_KEY": "yunpan_xxxxxxxxxx"
      }
    }
  }
}

Streamable HTTP 方式

无需安装本地环境，通过 URL 直接接入：

{
  "mcpServers": {
    "360-ai-cloud-disk": {
      "url": "https://mcp.yunpan.com/mcp?api_key=yunpan_xxxxxxxxxx"
    }
  }
}

SSE 方式

基于 HTTP 长连接的服务器推送：

{
  "mcpServers": {
    "360-ai-cloud-disk": {
      "url": "https://mcp.yunpan.com/sse?api_key=yunpan_xxxxxxxxxx"
    }
  }
}

CLI 使用

# 登录
360disk auth login --api-key yunpan_xxxxxxxxxx

# 常用操作
360disk dir ls /                                # 列出目录
360disk file search "报告"                      # 搜索文件
360disk file upload ./report.pdf --dest /文档/   # 上传文件
360disk file download <nid> --dir ./            # 下载文件
360disk file share /文档/报告.pdf                # 分享文件

功能概览

MCP 工具（11 个）

| 工具 | 说明 | |------|------| | file-list | 获取目录文件列表 | | file-search | 搜索文件 | | file-save | 保存文件到云盘（URL / 文本内容） | | file-share | 生成分享链接 | | file-move | 移动文件或文件夹 | | file-rename | 重命名文件或文件夹 | | make-dir | 创建目录 | | get-download-url | 获取下载链接 | | user-info | 获取用户信息 | | file-upload-stdio | 上传本地文件（仅 Stdio 模式） | | file-download-stdio | 下载云盘文件（仅 Stdio 模式） |

CLI 命令（18 个）

| 命令组 | 子命令 | 说明 | |--------|--------|------| | auth | login / whoami / logout | 鉴权管理 | | user | info | 用户信息 | | dir | ls / mkdir | 目录操作 | | file | mv / rename / rm / search / share / url / save / upload / download | 文件操作 | | completion | install / uninstall / script | Shell 补全 |

CLI 特性

• 结构化输出：默认 JSON，支持 --format text 和 --quiet 模式
• 统一错误码：10 个语义化错误码，进程退出码对应
• 管道集成：stdin 输入、批量操作，可与 jq 等工具组合
• 超时/重试：--timeout 和 --retries 全局选项
• Shell 补全：bash / zsh 自动补全

Skills 技能库

项目提供两种互补的 Skill 接入方式：

| 维度 | CLI Skill（推荐） | MCP Skill | |------|-------------------|-----------| | 执行方式 | Shell 命令 360disk ... | Python executor → MCP Server | | 运行时 | Node.js | Python + Node.js | | 命令数量 | 18 个 | 10 个 | | 适用场景 | Claude Code / Cursor / Windsurf / CI/CD | OpenClaw / Claude Desktop / 各类 Agent 平台 | | 特色能力 | 管道组合、批量操作、文件上传下载 | HTTP 远程模式、免安装、75%+ Token 节省 |

Skills 仓库：github.com/yifangyun/ecs-yunpan-skills

认证

使用前需要 360 AI 云盘 API 密钥（yunpan_ 开头），获取方式参见 快速接入指南。

鉴权优先级：--api-key 参数 > API_KEY 环境变量 > ~/.360disk/config.json

文档

• 在线文档 — 完整的接入指南和 API 参考
• MCP Server 快速开始
• CLI 命令参考
• Skills 使用指南
• Agent 接入指南

许可证

Apache-2.0