360 AI 云盘 MCP

360 AI 云盘的 Model Context Protocol 接入服务让 AI 模型能够通过 MCP 协议直接操作云盘提供完整的云盘文件管理能力

简介

本项目为 360 AI 云盘的 MCPModel Context Protocol服务实现允许各类 AI 模型如大语言模型通过标准的 MCP 协议与 360 AI 云盘进行交互通过这种方式AI 模型可以帮助用户管理云盘文件极大地提升了文件管理的智能化和便捷性

配置方式在 Cursor 中配置

Stdio 接入方式

在 ~/.cursor/mcp.json 文件中添加以下配置连接 360 AI 云盘 MCP 服务

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

Streamable HTTP 接入方式

如果您希望通过HTTP方式接入可以使用以下配置

{
  "mcpServers": {
    "mcp-server-disk-http": {
      "url": "https://mcp.yunpan.com/mcp?api_key=_xxxxxxxxx"
    }
  }
}

Streamable HTTP接入方式的特点

• 无需安装 nodejs 环境
• 无需下载到本地运行
• 通过URL参数传递API_KEY进行认证
• 适合需要HTTP接口的集成场景

SSE 接入方式

如果您希望通过SSEServer-Sent Events方式接入可以使用以下配置

{
  "mcpServers": {
    "mcp-server-disk-sse": {
      "url": "https://mcp.yunpan.com/sse?api_key=_xxxxxxxxx"
    }
  }
}

SSE接入方式的特点

• 基于HTTP长连接的服务器推送技术
• 实时性更强适合需要即时响应的场景
• 单向通信服务器向客户端推送数据
• 无需安装额外环境浏览器原生支持
• 通过URL参数传递API_KEY进行认证

认证配置

使用 360 AI 云盘 MCP 服务需要以下认证信息

• API_KEY360AI云盘 API 密钥格式为 "yunpan_" 开头的字符串

您可以通过以下方式获取API_KEY

• 参照 快速接入 MCP Server

360 AI 云盘开放平台优势

360 AI 云盘开放平台提供了多元化的产品能力和一站式文件服务

• 账号一键关联无需重新注册账号现有360 AI 云盘账号一键关联实现"多平台一账号"的无缝登录体验
• 支持 MCP 协议接入支持 Stdio/SSH/Streamable HTTP/SSE 协议通过 MCP Client 轻松接入
• 丰富接口能力提供文件上传下载搜索新建重命名移动分享等 API满足不同场景需求

访问 360 AI 云盘开放平台官网 获取更多详细信息和最新的开发文档

功能概览

本 MCP 服务提供与 360AI 云盘交互的多种操作包括

• 文件列表浏览 - 查看云盘目录内容
• 文件搜索 - 根据关键词搜索云盘文件
• 文件上传 - 将文件上传至 360 云盘
• 文件下载 - 获取云盘文件下载链接并支持直接下载
• 视频下载 - 通过URL下载视频到云盘支持批量下载和实时进度监控
• 文件保存 - 通过URL或文本内容保存文件到云盘
• 目录创建 - 在云盘中创建新文件夹
• 文件重命名 - 修改云盘文件或文件夹名称
• 文件移动 - 将文件移动到其他位置
• 文件分享 - 将指定文件生成分享链接
• 用户个人信息 - 获取用户信息

工具使用指南

当连接到 360 AI 云盘 MCP 服务后可以使用以下工具与云盘交互

文件上传 (file-upload-stdio) - 仅支持Stdio接入方式

将本地文件上传到 360 AI云盘指定路径

参数

• filePaths: 本地文件的完整路径必填可以是字符串数组包含多个文件
• uploadPath: 上传到云盘的目标目录默认为根目录 /

示例

{
  "filePaths": ["/Users/username/Documents/报告.docx", "/Users/username/Documents/数据.xlsx"],
  "uploadPath": "/工作文件"
}

单文件上传示例

{
  "filePaths": "/Users/username/Desktop/测试文档.pdf",
  "uploadPath": "/文档"
}

文件下载 (file-download-stdio) - 仅支持Stdio接入方式

获取云盘中指定文件的下载链接并支持直接下载文件

参数

• nid: 文件的唯一标识ID可通过文件列表或搜索获取必填
• auto: 是否直接下载文件默认为true
• downloadDir: 指定下载目录必须有读写权限默认为用户主目录下的.mcp-downloads文件夹

仅获取下载链接示例

{
  "nid": "12345678",
  "auto": false
}

下载到指定目录示例

{
  "nid": "12345678",
  "auto": true,
  "downloadDir": "/Users/username/Downloads"
}

文件列表查询 (file-list)

获取 360 AI云盘指定路径下的文件和文件夹列表

参数

• path: 要查询的路径默认为根目录 /
• page: 页码默认为 0
• page_size: 每页显示条数默认为 50

示例

{
  "path": "/文档",
  "page": 1,
  "page_size": 20
}

文件搜索 (file-search)

根据关键词搜索 360 AI云盘文件

参数

• key: 搜索关键词必填
• file_category: 文件类型-1:全部0:其他1:图片2:文档3:音乐4:视频默认为 -1
• page: 页码默认为 1
• page_size: 每页显示条数默认为 20

示例

{
  "key": "报告",
  "file_category": 2,
  "page": 1
}

文件保存 (file-save)

通过URL或文本内容保存文件到云盘

参数

• url: 文件下载地址url或content必传1个
• content: 文件内容支持markdown格式url或content必传1个
• upload_path: 云盘存储路径必须以/开头默认为"/来自mcp_server/"

通过URL保存示例

{
  "url": "https://example.com/sample.pdf",
  "upload_path": "/文档/下载/"
}

通过文本内容保存示例

{
  "content": "# 标题\n这是一段Markdown格式的文本内容",
  "upload_path": "/笔记/"
}

视频下载 (video-download)

通过URL下载视频到云盘支持批量下载和实时进度监控此操作可能需要较长时间建议客户端设置更长的超时时间建议300秒以上

参数

• urls: 视频URL多个URL使用英文竖线'|'分隔必填

单视频下载示例

{
  "urls": "https://example.com/video.mp4"
}

批量视频下载示例

{
  "urls": "https://example.com/video1.mp4|https://example.com/video2.mp4|https://example.com/video3.mp4"
}

功能特点

• 批量下载支持同时下载多个视频URL
• 实时进度提供详细的下载进度监控包括任务状态分布
• 自动轮询自动轮询任务状态直到完成无需手动查询
• 云盘存储下载的视频直接保存到云盘提供云盘文件链接
• 状态跟踪实时跟踪任务状态待开始/下载中/下载成功/上传成功/失败
• 便捷访问完成后提供云盘文件链接方便直接访问

返回结果说明

• 成功下载的视频会显示云盘文件路径文件大小访问链接等信息
• 失败的视频会显示具体的失败原因
• 支持结构化数据返回便于程序处理

创建文件夹 (make-dir)

在 360 AI云盘中创建新文件夹

参数

• fname: 文件夹路径例如/新文件夹/必填

示例

{
  "fname": "/工作文件/项目A/"
}

文件分享 (file-share)

将指定文件生成分享链接

参数

• paths: 要分享的文件路径多个文件路径用竖线(|)隔开必填

示例

{
  "paths": "/文档/报告.docx|/文档/数据.xlsx"
}

移动文件 (file-move)

移动 360 AI云盘中的文件或文件夹到新位置

参数

• src_name: 文件原路径多个路径用竖线隔开必填
• new_name: 目标路径必填

示例

{
  "src_name": "/文档/报告.docx|/文档/数据.xlsx",
  "new_name": "/归档文件夹/"
}

重命名文件 (file-rename)

重命名 360AI 云盘中的文件或文件夹

参数

• src_name: 原路径名称如/文件夹/旧文件名.txt必填
• new_name: 新名称如新文件名.txt必填

示例

{
  "src_name": "/文档/草稿.docx",
  "new_name": "最终报告.docx"
}

用户个人信息 (user-info)

获取 360 AI云盘用户个人信息

参数

• 无

AI 应用场景

通过 360 AI 云盘 MCP 接入AI 可以帮助用户实现以下场景

• 智能文件整理AI 可以分析用户文件内容并自动归类整理
• 文档智能检索使用自然语言描述查找云盘内的文档
• 自动文件备份根据用户习惯提供智能备份建议
• 文件内容分析分析文档内容并提供摘要或见解
• 基于对话的文件操作用户可以通过对话方式管理云盘文件
• 文件上传及分享用户可以通过对话方式保存文件到云盘并生成文件分享链接方便把文件分享给他人
• 网络资源保存用户可以通过提供URL让AI帮助将网络资源保存到云盘
• 文件内容创建与保存AI可以根据用户需求创建文档内容并直接保存到云盘
• 云盘文件下载用户可以通过对话方式从云盘下载文件到本地
• 视频资源下载用户可以通过提供视频URL让AI帮助将视频下载到云盘支持批量下载和进度监控

关键词

• 360 AI 云盘
• mcp
• modelcontextprotocol
• ai助手
• 文件管理
• 视频下载
• 批量下载
• sse
• streamable http

许可证

Apache-2.0