@aicloud360/mcp-server-disk 0.3.4 → 0.4.0

package/README.md

@@ -9,7 +9,9 @@
 
 本项目为 360 AI 云盘的 MCP（Model Context Protocol）服务实现，允许各类 AI 模型（如大语言模型）通过标准的 MCP 协议与 360 AI 云盘进行交互。通过这种方式，AI 模型可以帮助用户管理云盘文件，极大地提升了文件管理的智能化和便捷性。
 
-## 🔧 在 Cursor 中配置
+## 🔧 配置方式（在 Cursor 中配置）
+
+###  Stdio 接入方式
 
 在 `~/.cursor/mcp.json` 文件中添加以下配置，连接 360 AI 云盘 MCP 服务：
 
@@ -30,6 +32,47 @@
 }
 ```
 
+### Streamable HTTP 接入方式
+
+如果您希望通过HTTP方式接入，可以使用以下配置：
+
+```json
+{
+  "mcpServers": {
+    "mcp-server-disk-http": {
+      "url": "https://mcp.yunpan.360.cn/mcp?api_key=_xxxxxxxxx"
+    }
+  }
+}
+```
+
+Streamable HTTP接入方式的特点：
+- 无需安装 nodejs 环境
+- 无需下载到本地运行
+- 通过URL参数传递API_KEY进行认证
+- 适合需要HTTP接口的集成场景
+
+### SSE 接入方式
+
+如果您希望通过SSE（Server-Sent Events）方式接入，可以使用以下配置：
+
+```json
+{
+  "mcpServers": {
+    "mcp-server-disk-http": {
+      "url": "https://mcp.yunpan.360.cn/sse?api_key=_xxxxxxxxx"
+    }
+  }
+}
+```
+
+SSE接入方式的特点：
+- 基于HTTP长连接的服务器推送技术
+- 实时性更强，适合需要即时响应的场景
+- 单向通信，服务器向客户端推送数据
+- 无需安装额外环境，浏览器原生支持
+- 通过URL参数传递API_KEY进行认证
+
 ## 🔐 认证配置
 
 使用 360 AI 云盘 MCP 服务需要以下认证信息：
@@ -37,17 +80,17 @@
 - `API_KEY`：360AI云盘 API 密钥，格式为 "yunpan_" 开头的字符串
 
 您可以通过以下方式获取API_KEY：
-   - 参照 [快速接入](https://qa-open.yunpan.360.cn/metro/docs/mcp-server/preparation) MCP Server
+   - 参照 [快速接入](https://open.yunpan.360.cn/docs/mcp-server/preparation) MCP Server
 
 ### 360 AI 云盘开放平台优势
 
 360 AI 云盘开放平台提供了多元化的产品能力和一站式文件服务：
 
 - **账号一键关联**：无需重新注册账号，现有360 AI 云盘账号一键关联，实现"多平台，一账号"的无缝登录体验
-- **支持 MCP 协议接入**：支持 Stdio/SSH/Streamable HTTP 协议，通过 MCP Client 轻松接入
+- **支持 MCP 协议接入**：支持 Stdio/SSH/Streamable HTTP/SSE 协议，通过 MCP Client 轻松接入
 - **丰富接口能力**：提供文件上传、下载、搜索、新建、重命名、移动、分享等 API，满足不同场景需求
 
-访问 [360 AI 云盘开放平台官网](https://qa-open.yunpan.360.cn/metro/) 获取更多详细信息和最新的开发文档。
+访问 [360 AI 云盘开放平台官网](https://open.yunpan.360.cn) 获取更多详细信息和最新的开发文档。
 
 ## ✨ 功能概览
 
@@ -56,10 +99,12 @@
 - 📁 文件列表浏览 - 查看云盘目录内容
 - 🔍 文件搜索 - 根据关键词搜索云盘文件
 - ⬆️ 文件上传 - 将文件上传至 360 云盘
+- ⬇️ 文件下载 - 获取云盘文件下载链接并支持直接下载
+- 💾 文件保存 - 通过URL或文本内容保存文件到云盘
 - 📂 目录创建 - 在云盘中创建新文件夹
 - ✏️ 文件重命名 - 修改云盘文件或文件夹名称
 - 🚚 文件移动 - 将文件移动到其他位置
-- 🗑️ 文件分享 - 将指定文件生成分享链接
+- 🔗 文件分享 - 将指定文件生成分享链接
 - 🔑 用户个人信息 - 获取用户信息
 
 ## 🛠️ 工具使用指南
@@ -127,6 +172,57 @@
 }
 ```
 
+### 文件保存 (file-save)
+
+通过URL或文本内容保存文件到云盘。
+
+**参数：**
+- `url`: 文件下载地址（url或content必传1个）
+- `content`: 文件内容，支持markdown格式（url或content必传1个）
+- `upload_path`: 云盘存储路径，必须以/开头，默认为"/来自：mcp_server/"
+
+**通过URL保存示例：**
+```json
+{
+  "url": "https://example.com/sample.pdf",
+  "upload_path": "/文档/下载/"
+}
+```
+
+**通过文本内容保存示例：**
+```json
+{
+  "content": "# 标题\n这是一段Markdown格式的文本内容",
+  "upload_path": "/笔记/"
+}
+```
+
+### 文件下载 (file-download-stdio)
+
+获取云盘中指定文件的下载链接并支持直接下载文件。
+
+**参数：**
+- `nid`: 文件的唯一标识ID，可通过文件列表或搜索获取（必填）
+- `auto`: 是否直接下载文件，默认为true
+- `downloadDir`: 指定下载目录，必须有读写权限，默认为用户主目录下的.mcp-downloads文件夹
+
+**仅获取下载链接示例：**
+```json
+{
+  "nid": "12345678",
+  "auto": false
+}
+```
+
+**下载到指定目录示例：**
+```json
+{
+  "nid": "12345678",
+  "auto": true,
+  "downloadDir": "/Users/username/Downloads"
+}
+```
+
 ### 创建文件夹 (make-dir)
 
 在 360 AI云盘中创建新文件夹。
@@ -204,7 +300,10 @@
 - **自动文件备份**：根据用户习惯，提供智能备份建议
 - **文件内容分析**：分析文档内容并提供摘要或见解
 - **基于对话的文件操作**：用户可以通过对话方式管理云盘文件
-- **文件上传及分享**：用户可以通过对话方式保存文件到云盘，并生成文件分享链接，方便把文件分享给他人。
+- **文件上传及分享**：用户可以通过对话方式保存文件到云盘，并生成文件分享链接，方便把文件分享给他人
+- **网络资源保存**：用户可以通过提供URL，让AI帮助将网络资源保存到云盘
+- **文件内容创建与保存**：AI可以根据用户需求创建文档内容，并直接保存到云盘
+- **云盘文件下载**：用户可以通过对话方式从云盘下载文件到本地
 
 ## 🔑 关键词
 
@@ -213,6 +312,7 @@
 - modelcontextprotocol
 - ai助手
 - 文件管理
+- sse
 
 ## 📄 许可证