@aicloud360/mcp-server-disk 0.5.0 → 0.5.2
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 +52 -54
- package/build/index.js +1 -1
- package/package.json +9 -1
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-
|
|
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
|
|