Allows saving content in Markdown format directly to 360 AI Cloud Drive, supporting formatted text storage through the file-save tool.
360 AI 云盘 MCP
360 AI 云盘的 Model Context Protocol 接入服务,让 AI 模型能够通过 MCP 协议直接操作云盘,提供完整的云盘文件管理能力。
📚 简介
本项目为 360 AI 云盘的 MCP(Model Context Protocol)服务实现,允许各类 AI 模型(如大语言模型)通过标准的 MCP 协议与 360 AI 云盘进行交互。通过这种方式,AI 模型可以帮助用户管理云盘文件,极大地提升了文件管理的智能化和便捷性。
🔧 配置方式(在 Cursor 中配置)
Stdio 接入方式
在 ~/.cursor/mcp.json
文件中添加以下配置,连接 360 AI 云盘 MCP 服务:
Streamable HTTP 接入方式
如果您希望通过HTTP方式接入,可以使用以下配置:
Streamable HTTP接入方式的特点:
- 无需安装 nodejs 环境
- 无需下载到本地运行
- 通过URL参数传递API_KEY进行认证
- 适合需要HTTP接口的集成场景
SSE 接入方式
如果您希望通过SSE(Server-Sent Events)方式接入,可以使用以下配置:
SSE接入方式的特点:
- 基于HTTP长连接的服务器推送技术
- 实时性更强,适合需要即时响应的场景
- 单向通信,服务器向客户端推送数据
- 无需安装额外环境,浏览器原生支持
- 通过URL参数传递API_KEY进行认证
🔐 认证配置
使用 360 AI 云盘 MCP 服务需要以下认证信息:
API_KEY
:360AI云盘 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
: 上传到云盘的目标目录,默认为根目录/
示例:
单文件上传示例:
文件下载 (file-download-stdio) - 仅支持Stdio接入方式
获取云盘中指定文件的下载链接并支持直接下载文件。
参数:
nid
: 文件的唯一标识ID,可通过文件列表或搜索获取(必填)auto
: 是否直接下载文件,默认为truedownloadDir
: 指定下载目录,必须有读写权限,默认为用户主目录下的.mcp-downloads文件夹
仅获取下载链接���例:
下载到指定目录示例:
文件列表查询 (file-list)
获取 360 AI云盘指定路径下的文件和文件夹列表。
参数:
path
: 要查询的路径,默认为根目录/
page
: 页码,默认为 0page_size
: 每页显示条数,默认为 50
示例:
文件搜索 (file-search)
根据关键词搜索 360 AI云盘文件。
参数:
key
: 搜索关键词(必填)file_category
: 文件类型(-1:全部,0:其他,1:图片,2:文档,3:音乐,4:视频),默认为 -1page
: 页码,默认为 1page_size
: 每页显示条数,默认为 20
示例:
文件保存 (file-save)
通过URL或文本内容保存文件到云盘。
参数:
url
: 文件下载地址(url或content必传1个)content
: 文件内容,支持markdown格式(url或content必传1个)upload_path
: 云盘存储路径,必须以/开头,默认为"/来自:mcp_server/"
通过URL保存示例:
通过文本内容保存示例:
视频下载 (video-download)
通过URL下载视频到云盘,支持批量下载和实时进度监控。此操作可能需要较长时间,建议客户端设置更长的超时时间(建议300秒以上)。
参数:
urls
: 视频URL,多个URL使用英文竖线'|'分隔(必填)
单视频下载示例:
批量视频下载示例:
功能特点:
- 🎯 批量下载:支持同时下载多个视频URL
- 📊 实时进度:提供详细的下载进度监控,包括任务状态分布
- 🔄 自动轮询:自动轮询任务状态直到完成,无需手动查询
- 📁 云盘存储:下载的视频直接保存到云盘,提供云盘文件链接
- ⚡ 状态跟踪:实时跟踪任务状态(待开始/下载中/下载成功/上传成功/失败)
- 🔗 便捷访问:完成后提供云盘文件链接,方便直接访问
返回结果说明:
- 成功下载的视频会显示云盘文件路径、文件大小、访问链接等信息
- 失败的视频会显示具体的失败原因
- 支持结构化数据返回,便于程序处理
创建文件夹 (make-dir)
在 360 AI云盘中创建新文件夹。
参数:
fname
: 文件夹路径,例如:/新文件夹/
(必填)
示例:
文件分享 (file-share)
将指定文件生成分享链接。
参数:
paths
: 要分享的文件路径,多个文件路径用竖线(|)隔开(必填)
示例:
移动文件 (file-move)
移动 360 AI云盘中的文件或文件夹到新位置。
参数:
src_name
: 文件原路径,多个路径用竖线隔开(必填)new_name
: 目标路径(必填)
示例:
重命名文件 (file-rename)
重命名 360AI 云盘中的文件或文件夹。
参数:
src_name
: 原路径名称,如:/文件夹/旧文件名.txt
(必填)new_name
: 新名称,如:新文件名.txt
(必填)
示例:
用户个人信息 (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
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
An implementation of the Model Context Protocol that allows AI models to interact with 360 AI Cloud Drive, providing comprehensive file management capabilities including uploading, downloading, searching, and sharing files.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol (MCP) server that allows AI models to safely access and interact with local file systems, enabling reading file contents, listing directories, and retrieving file metadata.Last updated -89JavaScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that exposes Cloudinary Upload & Admin API methods as tools by AI assistants. This integration allows AI systems to trigger and interact with your Cloudinary cloud.Last updated -5430JavaScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that extends AI capabilities by providing file system access and management functionalities to Claude or other AI assistants.Last updated -2966TypeScript
- -securityAlicense-qualityEnables AI applications to interact with decentralized storage through a standardized Model Context Protocol interface, allowing file uploads, retrievals, and identity management.Last updated -11TypeScriptApache 2.0