360 AI云盘的模型上下文协议访问服务使AI模型能够通过MCP协议直接操作云盘,提供完整的云盘文件管理能力。
本项目是360 AI云盘的MCP(Model Context Protocol)服务实现,允许各种AI模型(如大型语言模型)通过标准的MCP协议与360 AI云盘进行交互。这样,AI模型可以帮助用户管理云盘文件,极大地提高了文件管理的智能化和便捷性。
在 ~/.cursor/mcp.json 文件中添加以下配置以连接到360 AI云盘MCP服务:
{
"mcpServers": {
"360-mcp-server-disk": {
"command": "npx",
"args": [
"-y",
"@aicloud360/mcp-server-disk"
],
"env": {
"API_KEY": "_xxxxxxxxx"
}
}
}
}
如果希望通过HTTP访问,可以使用以下配置:
{
"mcpServers": {
"mcp-server-disk-http": {
"url": "https://mcp.yunpan.com/mcp?api_key=_xxxxxxxxx"
}
}
}
可流式HTTP访问方法的特点:
如果希望通过SSE(Server-Sent Events)访问,可以使用以下配置:
{
"mcpServers": {
"mcp-server-disk-sse": {
"url": "https://mcp.yunpan.com/sse?api_key=_xxxxxxxxx"
}
}
}
SSE访问方法的特点:
要使用360 AI云盘MCP服务,需要以下认证信息:
API_KEY:360AI云盘API密钥,格式为以"yunpan_"开头的字符串可以通过以下方式获取API_KEY:
360 AI云盘开放平台提供了多样化的产品能力和一站式文件服务:
访问360 AI云盘开放平台官方网站 获取更多详细信息和最新开发文档。
此MCP服务提供了与360AI云存储交互的各种操作,包括:
连接到360 AI云盘MCP服务后,可以使用以下工具与云盘进行交互:
将本地文件上传至360 AI云盘的指定路径。
参数
filePaths:本地文件的完整路径(必需,可以是一个包含多个文件的字符串数组)uploadPath:上传至云盘的目标目录,默认为根目录 /示例:
{
"filePaths": ["/Users/username/Documents/报告.docx", "/Users/username/Documents/数据.xlsx"],
"uploadPath": "/工作文件"
}
单个文件上传示例:
{
"filePaths": "/Users/username/Desktop/测试文档.pdf",
"uploadPath": "/文档"
}
获取云盘中指定文件的下载链接,并支持直接文件下载。
参数
nid:文件的唯一标识ID,可以通过文件列表或搜索获得(必需)auto:是否直接下载文件,默认为truedownloadDir:指定下载目录,必须具有读写权限,默认为用户主目录下的.mcp-downloads文件夹仅获取下载链接示例:
{
"nid": "12345678",
"auto": false
}
下载至指定目录示例:
{
"nid": "112345678",
"auto": true,
"downloadDir": "/Users/username/Downloads"
}
检索360 AI云盘指定路径下的文件和文件夹列表。
参数
path:要查询的路径,默认为根目录 /page:页码,默认为0page_size:每页显示的条目数,默认为50示例:
{
"path": "/文档",
"page": 1,
"page_size": 20
}
根据关键词搜索360 AI云盘文件。
参数
key:搜索关键词(必需)file_category:文件类型(-1:全部,0:其他,1:图片,2:文档,3:音乐,4:视频),默认为-1page:页码,默认为1page_size:每页显示的条目数,默认为20示例:
{
"key": "报告",
"file_category": 2,
"page": 1
}
通过URL或文本内容将文件保存至云盘。
参数
url:文件下载地址(必需,需提供URL或内容之一)content:文件内容,支持markdown格式(必需,需提供URL或内容之一)upload_path:云盘存储路径,必须以/开头,默认为"/from: mcp_userver/"通过URL保存示例:
{
"url": "https://example.com/sample.pdf",
"upload_path": "/文档/下载/"
}
通过文本内容保存示例:
{
"content": "# 标题\n这是一段Markdown格式的文本内容",
"upload_path": "/笔记/"
}
通过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"
}
特点:
返回结果解释:
在360 AI云盘中创建新的文件夹。
参数
fname:文件夹路径,例如:/新文件夹/(必需)示例:
{
"fname": "/工作文件/项目A/"
}
生成指定文件的分享链接。
参数
paths:要分享的文件路径,多个文件路径之间用竖线(|)分隔(必需)示例:
{
"paths": "/文档/报告.docx|/文档/数据.xlsx"
}
将360 AI云盘中的文件或文件夹移动至新位置。
参数
src_name:原始文件路径,多个路径之间用竖线分隔(必需)new_name:目标路径(必需)示例:
{
"src_name": "/文档/报告.docx|/文档/数据.xlsx",
"new_name": "/归档文件夹/"
}
重命名360AI云盘中的文件或文件夹。
参数
src_name:原始路径名,例如:/文件夹/旧文件名.txt(必需)new_name:新名称,例如:新文件名.txt(必需)示例:
{
"src_name": "/文档/草稿.docx",
"new_name": "最终报告.docx"
}
获取360 AI云盘用户的个人资料。
参数
通过集成360 AI云盘MCP,AI可以协助用户实现以下场景:
Apache-2.0