ecs_mcp服务器

Name: ecs_mcp服务器
Author: Qihoo360

作者：Qihoo3603 星标更新：2025-10-31

安装使用来源：spider==github.com

项目介绍

360 AI云盘 MCP

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访问方法

如果希望通过HTTP访问，可以使用以下配置：

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

可流式HTTP访问方法的特点：

不需要安装Node.js环境
不需要下载并本地运行
通过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/可流式HTTP/SSE协议，可通过MCP客户端轻松访问
丰富的接口能力：提供文件上传、下载、搜索、创建、重命名、移动、分享等API，满足不同场景需求

访问360 AI云盘开放平台官方网站获取更多详细信息和最新开发文档。

✨ 功能概述

此MCP服务提供了与360AI云存储交互的各种操作，包括：

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

🛠️ 工具使用指南

连接到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：是否直接下载文件，默认为true
downloadDir：指定下载目录，必须具有读写权限，默认为用户主目录下的.mcp-downloads文件夹

仅获取下载链接示例：

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

下载至指定目录示例：

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

文件列表查询

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

参数

path：要查询的路径，默认为根目录 /
page：页码，默认为0
page_size：每页显示的条目数，默认为50

示例：

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

文件搜索

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

参数

key：搜索关键词（必需）
file_category：文件类型（-1：全部，0：其他，1：图片，2：文档，3：音乐，4：视频），默认为-1
page：页码，默认为1
page_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"
}

特点：

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

返回结果解释：

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

创建文件夹（make dir）

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

参数

fname：文件夹路径，例如：/新文件夹/（必需）

示例：

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

文件分享

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

参数

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"
}

用户信息

获取360 AI云盘用户的个人资料。

参数

🧠 AI应用场景

通过集成360 AI云盘MCP，AI可以协助用户实现以下场景：

智能文件分类：AI可以分析用户文件的内容并自动分类整理
智能文档检索：使用自然语言描述在云存储中搜索文档
自动文件备份：基于用户习惯提供智能备份建议
文件内容分析：分析文档内容并提供总结或见解
对话式文件管理：用户可以通过对话管理云盘文件
文件上传与分享：用户可以通过对话将文件保存至云盘并生成文件分享链接，方便与其他用户共享文件
网络资源保存：用户可以使用AI帮助保存网络资源至云存储，提供URL
创建并保存文件内容：AI可以根据用户需求创建文档内容并直接保存至云存储
云盘文件下载：用户可以通过对话从云盘下载文件至本地设备
视频资源下载：用户可以提供视频URL，AI辅助将视频下载至云存储，支持批量下载及进度监控

🔑 关键词

360 AI云盘
mcp
modelcontextprotocol
AI助手
文件管理
视频下载
批量下载
ss
可流式http

📄 许可证

Apache-2.0