@aicloud360/mcp-server-disk 0.5.1 → 0.5.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,9 +2,6 @@
2
2
 
3
3
  360 AI 云盘的 Model Context Protocol 接入服务,让 AI 模型能够通过 MCP 协议直接操作云盘,提供完整的云盘文件管理能力。
4
4
 
5
- <div align="center">
6
- </div>
7
-
8
5
  ## 📚 简介
9
6
 
10
7
  本项目为 360 AI 云盘的 MCP(Model Context Protocol)服务实现,允许各类 AI 模型(如大语言模型)通过标准的 MCP 协议与 360 AI 云盘进行交互。通过这种方式,AI 模型可以帮助用户管理云盘文件,极大地提升了文件管理的智能化和便捷性。
@@ -59,7 +56,7 @@ Streamable HTTP接入方式的特点:
59
56
  ```json
60
57
  {
61
58
  "mcpServers": {
62
- "mcp-server-disk-http": {
59
+ "mcp-server-disk-sse": {
63
60
  "url": "https://mcp.yunpan.com/sse?api_key=_xxxxxxxxx"
64
61
  }
65
62
  }
@@ -112,6 +109,56 @@ SSE接入方式的特点:
112
109
 
113
110
  当连接到 360 AI 云盘 MCP 服务后,可以使用以下工具与云盘交互:
114
111
 
112
+ ### 文件上传 (file-upload-stdio) - 仅支持Stdio接入方式
113
+
114
+ 将本地文件上传到 360 AI云盘指定路径。
115
+
116
+ **参数:**
117
+ - `filePaths`: 本地文件的完整路径(必填,可以是字符串数组包含多个文件)
118
+ - `uploadPath`: 上传到云盘的目标目录,默认为根目录 `/`
119
+
120
+ **示例:**
121
+ ```json
122
+ {
123
+ "filePaths": ["/Users/username/Documents/报告.docx", "/Users/username/Documents/数据.xlsx"],
124
+ "uploadPath": "/工作文件"
125
+ }
126
+ ```
127
+
128
+ **单文件上传示例:**
129
+ ```json
130
+ {
131
+ "filePaths": "/Users/username/Desktop/测试文档.pdf",
132
+ "uploadPath": "/文档"
133
+ }
134
+ ```
135
+
136
+ ### 文件下载 (file-download-stdio) - 仅支持Stdio接入方式
137
+
138
+ 获取云盘中指定文件的下载链接并支持直接下载文件。
139
+
140
+ **参数:**
141
+ - `nid`: 文件的唯一标识ID,可通过文件列表或搜索获取(必填)
142
+ - `auto`: 是否直接下载文件,默认为true
143
+ - `downloadDir`: 指定下载目录,必须有读写权限,默认为用户主目录下的.mcp-downloads文件夹
144
+
145
+ **仅获取下载链接示例:**
146
+ ```json
147
+ {
148
+ "nid": "12345678",
149
+ "auto": false
150
+ }
151
+ ```
152
+
153
+ **下载到指定目录示例:**
154
+ ```json
155
+ {
156
+ "nid": "12345678",
157
+ "auto": true,
158
+ "downloadDir": "/Users/username/Downloads"
159
+ }
160
+ ```
161
+
115
162
  ### 文件列表查询 (file-list)
116
163
 
117
164
  获取 360 AI云盘指定路径下的文件和文件夹列表。
@@ -149,30 +196,6 @@ SSE接入方式的特点:
149
196
  }
150
197
  ```
151
198
 
152
- ### 文件上传 (upload-file)
153
-
154
- 将本地文件上传到 360 AI云盘指定路径。
155
-
156
- **参数:**
157
- - `filePaths`: 本地文件的完整路径(必填,可以是字符串数组包含多个文件)
158
- - `uploadPath`: 上传到云盘的目标目录,默认为根目录 `/`
159
-
160
- **示例:**
161
- ```json
162
- {
163
- "filePaths": ["/Users/username/Documents/报告.docx", "/Users/username/Documents/数据.xlsx"],
164
- "uploadPath": "/工作文件"
165
- }
166
- ```
167
-
168
- **单文件上传示例:**
169
- ```json
170
- {
171
- "filePaths": "/Users/username/Desktop/测试文档.pdf",
172
- "uploadPath": "/文档"
173
- }
174
- ```
175
-
176
199
  ### 文件保存 (file-save)
177
200
 
178
201
  通过URL或文本内容保存文件到云盘。
@@ -198,32 +221,6 @@ SSE接入方式的特点:
198
221
  }
199
222
  ```
200
223
 
201
- ### 文件下载 (file-download-stdio)
202
-
203
- 获取云盘中指定文件的下载链接并支持直接下载文件。
204
-
205
- **参数:**
206
- - `nid`: 文件的唯一标识ID,可通过文件列表或搜索获取(必填)
207
- - `auto`: 是否直接下载文件,默认为true
208
- - `downloadDir`: 指定下载目录,必须有读写权限,默认为用户主目录下的.mcp-downloads文件夹
209
-
210
- **仅获取下载链接示例:**
211
- ```json
212
- {
213
- "nid": "12345678",
214
- "auto": false
215
- }
216
- ```
217
-
218
- **下载到指定目录示例:**
219
- ```json
220
- {
221
- "nid": "12345678",
222
- "auto": true,
223
- "downloadDir": "/Users/username/Downloads"
224
- }
225
- ```
226
-
227
224
  ### 视频下载 (video-download)
228
225
 
229
226
  通过URL下载视频到云盘,支持批量下载和实时进度监控。此操作可能需要较长时间,建议客户端设置更长的超时时间(建议300秒以上)。
@@ -351,6 +348,7 @@ SSE接入方式的特点:
351
348
  - 视频下载
352
349
  - 批量下载
353
350
  - sse
351
+ - streamable http
354
352
 
355
353
  ## 📄 许可证
356
354