JinDaGe - ecs_mcp_server MCP Details

article

README

🚀 360 AI 云盘 MCP

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

🚀 快速开始

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

✨ 主要特性

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

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

📦 安装指南

配置方式（在 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 接入方式

如果您希望通过 SSE（Server - 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_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 云盘开放平台官网获取更多详细信息和最新的开发文档。

💻 使用示例

基础用法

以下是使用不同工具与 360 AI 云盘交互的示例：

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

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

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

单文件上传示例：

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

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

获取云盘中指定文件的下载链接并支持直接下载文件。仅获取下载链接示例：

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

下载到指定目录示例：

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

文件列表查询 (file - list)

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

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

文件搜索 (file - search)

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

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

文件保存 (file - save)

通过 URL 或文本内容保存文件到云盘。通过 URL 保存示例：

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

通过文本内容保存示例：

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

视频下载 (video - download)

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

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

批量视频下载示例：

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

创建文件夹 (make - dir)

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

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

文件分享 (file - share)

将指定文件生成分享链接。

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

移动文件 (file - move)

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

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

重命名文件 (file - rename)

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

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

用户个人信息 (user - info)

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

{
  // 无参数
}

高级用法

视频下载功能除了基础的单视频和批量视频下载，还具有以下高级特性：

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

返回结果说明：

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

📚 详细文档

AI 应用场景

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

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

关键词

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

📄 许可证

Apache - 2.0

ecs_mcp_server