Ecs MCP Server

🚀 360 AI Cloud Disk MCP

The Model Context Protocol (MCP) access service for 360 AI Cloud Disk enables AI models to directly operate the cloud disk via the MCP protocol, offering comprehensive cloud disk file management capabilities.

🚀 Quick Start

The 360 AI Cloud Disk MCP service allows AI models to interact with the cloud disk through the MCP protocol, providing users with intelligent and convenient file management features.

✨ Features

• Diverse Access Protocols: Supports Stdio, Streamable HTTP, and SSE protocols for flexible integration.
• Rich API Capabilities: Offers a wide range of APIs for file upload, download, search, creation, renaming, moving, and sharing.
• One - click Account Association: Seamlessly associates with existing 360 AI Cloud Disk accounts for a unified login experience.
• AI - Enabled File Management: Enables AI - powered scenarios such as intelligent file organization, retrieval, and backup.

📦 Installation

Configuration in Cursor

Stdio Access

Add the following configuration to the ~/.cursor/mcp.json file to connect to the 360 AI Cloud Disk MCP service:

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

Streamable HTTP Access

If you prefer to access via HTTP, use the following configuration:

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

Features of Streamable HTTP access:

• No need to install a nodejs environment.
• No need to download and run locally.
• Authenticates by passing the API_KEY as a URL parameter.
• Suitable for integration scenarios requiring HTTP interfaces.

SSE Access

If you want to access via SSE (Server - Sent Events), use the following configuration:

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

Features of SSE access:

• Based on the HTTP long - connection server - push technology.
• Provides stronger real - time performance, suitable for scenarios requiring immediate response.
• Supports one - way communication, where the server pushes data to the client.
• No need to install an additional environment, natively supported by browsers.
• Authenticates by passing the API_KEY as a URL parameter.

🔐 Authentication Configuration

To use the 360 AI Cloud Disk MCP service, you need the following authentication information:

• API_KEY: The 360AI Cloud Disk API key, a string starting with "yunpan_". You can obtain the API_KEY by referring to [Quick Access](https://open.yunpan.360.cn/docs/mcp - server/preparation) to the MCP Server.

Advantages of the 360 AI Cloud Disk Open Platform

The 360 AI Cloud Disk Open Platform offers diverse product capabilities and one - stop file services:

• One - click Account Association: No need to register a new account. Seamlessly associate with your existing 360 AI Cloud Disk account for a "multi - platform, single - account" login experience.
• MCP Protocol Support: Supports Stdio/SSH/Streamable HTTP/SSE protocols, easily accessible via the MCP Client.
• Rich Interface Capabilities: Provides APIs for file upload, download, search, creation, renaming, moving, and sharing to meet various scenario requirements. Visit the 360 AI Cloud Disk Open Platform Official Website for more detailed information and the latest development documentation.

💻 Usage Examples

File Upload (file - upload - stdio) - Stdio Access Only

Upload local files to a specified path on the 360 AI Cloud Disk. Parameters:

• filePaths: The full path of local files (required, can be an array of strings for multiple files).
• uploadPath: The target directory on the cloud disk, default is the root directory /. Example:

{
  "filePaths": ["/Users/username/Documents/Report.docx", "/Users/username/Documents/Data.xlsx"],
  "uploadPath": "/Work Files"
}

Single - file Upload Example:

{
  "filePaths": "/Users/username/Desktop/Test Document.pdf",
  "uploadPath": "/Documents"
}

File Download (file - download - stdio) - Stdio Access Only

Get the download link of a specified file on the cloud disk and support direct download. Parameters:

• nid: The unique ID of the file, obtainable from the file list or search (required).
• auto: Whether to directly download the file, default is true.
• downloadDir: The specified download directory, must have read and write permissions, default is the .mcp - downloads folder under the user's home directory. Example of Only Getting the Download Link:

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

Example of Downloading to a Specified Directory:

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

File List Query (file - list)

Get the list of files and folders in a specified path on the 360 AI Cloud Disk. Parameters:

• path: The path to query, default is the root directory /.
• page: The page number, default is 0.
• page_size: The number of items per page, default is 50. Example:

{
  "path": "/Documents",
  "page": 1,
  "page_size": 20
}

File Search (file - search)

Search for files on the 360 AI Cloud Disk based on keywords. Parameters:

• key: The search keyword (required).
• file_category: The file type (-1: all, 0: other, 1: image, 2: document, 3: music, 4: video), default is -1.
• page: The page number, default is 1.
• page_size: The number of items per page, default is 20. Example:

{
  "key": "Report",
  "file_category": 2,
  "page": 1
}

File Save (file - save)

Save a file to the cloud disk via a URL or text content. Parameters:

• url: The file download address (either url or content must be provided).
• content: The file content, supporting markdown format (either url or content must be provided).
• upload_path: The storage path on the cloud disk, must start with /, default is "/From: mcp_server/". Example of Saving via URL:

{
  "url": "https://example.com/sample.pdf",
  "upload_path": "/Documents/Downloads/"
}

Example of Saving via Text Content:

{
  "content": "# Title\nThis is a Markdown - formatted text content",
  "upload_path": "/Notes/"
}

Video Download (video - download)

Download videos to the cloud disk via URLs, supporting batch download and real - time progress monitoring. This operation may take a long time. It is recommended to set a longer timeout on the client side (suggested over 300 seconds). Parameters:

• urls: Video URLs, multiple URLs separated by the English vertical bar '|' (required). Single - video Download Example:

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

Batch - video Download Example:

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

Features:

• 🎯 Batch Download: Supports downloading multiple video URLs simultaneously.
• 📊 Real - time Progress: Provides detailed download progress monitoring, including task status distribution.
• 🔄 Automatic Polling: Automatically polls the task status until completion, no manual query required.
• 📁 Cloud Disk Storage: Downloads videos directly to the cloud disk and provides cloud disk file links.
• ⚡ Status Tracking: Tracks task status in real - time (pending/ downloading/ download successful/ upload successful/ failed).
• 🔗 Convenient Access: Provides cloud disk file links after completion for easy access. Return Result Explanation:
• Successfully downloaded videos will display information such as the cloud disk file path, file size, and access link.
• Failed videos will show the specific failure reason.
• Supports structured data return for easy program processing.

Create Folder (make - dir)

Create a new folder on the 360 AI Cloud Disk. Parameters:

• fname: The folder path, e.g., /New Folder/ (required). Example:

{
  "fname": "/Work Files/Project A/"
}

File Sharing (file - share)

Generate a sharing link for specified files. Parameters:

• paths: The paths of the files to share, multiple file paths separated by the vertical bar (|) (required). Example:

{
  "paths": "/Documents/Report.docx|/Documents/Data.xlsx"
}

Move File (file - move)

Move files or folders on the 360 AI Cloud Disk to a new location. Parameters:

• src_name: The original path of the file, multiple paths separated by the vertical bar (required).
• new_name: The target path (required). Example:

{
  "src_name": "/Documents/Report.docx|/Documents/Data.xlsx",
  "new_name": "/Archived Folders/"
}

Rename File (file - rename)

Rename files or folders on the 360 AI Cloud Disk. Parameters:

• src_name: The original path name, e.g., /Folder/Old File Name.txt (required).
• new_name: The new name, e.g., New File Name.txt (required). Example:

{
  "src_name": "/Documents/Draft.docx",
  "new_name": "Final Report.docx"
}

User Information (user - info)

Get the personal information of the 360 AI Cloud Disk user. Parameters:

• None

🧠 AI Application Scenarios

Through the 360 AI Cloud Disk MCP access, AI can help users achieve the following scenarios:

• Intelligent File Organization: AI can analyze user file content and automatically categorize and organize files.
• Intelligent Document Retrieval: Use natural language descriptions to find documents in the cloud disk.
• Automatic File Backup: Provide intelligent backup suggestions based on user habits.
• File Content Analysis: Analyze document content and provide summaries or insights.
• Dialog - based File Operations: Users can manage cloud disk files through dialogs.
• File Upload and Sharing: Users can save files to the cloud disk and generate sharing links through dialogs for easy sharing.
• Network Resource Saving: Users can provide URLs to let AI save network resources to the cloud disk.
• File Content Creation and Saving: AI can create document content according to user needs and save it directly to the cloud disk.
• Cloud Disk File Download: Users can download files from the cloud disk to the local via dialogs.
• Video Resource Download: Users can provide video URLs to let AI download videos to the cloud disk, supporting batch download and progress monitoring.

🔑 Keywords

• 360 AI Cloud Disk
• mcp
• modelcontextprotocol
• ai assistant
• file management
• video download
• batch download
• sse
• streamable http

📄 License

Apache - 2.0