Ecs MCP Server

🚀 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 雲盤開放平臺官網 獲取更多詳細信息和最新的開發文檔。

💻 使用示例

文件上傳 (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