sutong
750f981c7e
资源中心——从多渠道获取资源链接，转存到夸克网盘并整理归档。 - sources/tencent-doc: 腾讯文档读取 - sources/search: 网盘搜索 - storage/quark: 夸克网盘操作 - ref/: 来源 skill 参考归档 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
158 lines
4.9 KiB
Markdown
158 lines
4.9 KiB
Markdown
---
|
|
name: netdisk-mcp-server
|
|
description: Netdisk MCP Server — 夸克网盘和115网盘的文件浏览、转存、离线下载，以及PanSou多平台资源搜索。当用户需要查看网盘文件、转存分享链接、搜索影视资源、添加离线下载任务时使用此技能。
|
|
homepage: https://github.com/ptbsare/netdisk-mcp-server
|
|
metadata:
|
|
{
|
|
"openclaw":
|
|
{
|
|
"emoji": "☁️",
|
|
"requires": { "anyBins": ["mcporter", "npx"], "env": ["NETDISK_QUARK_COOKIE", "NETDISK_115_COOKIE"] },
|
|
"primaryEnv": "NETDISK_115_COOKIE",
|
|
"install":
|
|
[
|
|
{
|
|
"id": "node",
|
|
"kind": "node",
|
|
"package": "@ptbsare/netdisk-mcp-server",
|
|
"bins": ["netdisk-mcp-server"],
|
|
"label": "Install @ptbsare/netdisk-mcp-server (node)",
|
|
},
|
|
],
|
|
},
|
|
}
|
|
---
|
|
|
|
# Netdisk MCP Server
|
|
|
|
夸克网盘和115网盘的 MCP 操作服务器。支持文件浏览、CP-Like 转存、115 离线下载和 PanSou 多平台资源搜索。
|
|
|
|
## 什么时候使用？
|
|
|
|
**适用场景：**
|
|
- 浏览夸克/115 网盘目录内容
|
|
- 查看分享链接中的文件列表
|
|
- 从分享链接转存文件到自己的网盘（支持通配符过滤）
|
|
- 搜索电影、电视剧的网盘分享链接和磁力链接
|
|
- 添加 115 离线下载任务（磁力链接）
|
|
|
|
**不适用场景：**
|
|
- 文件在线播放
|
|
- 网盘账号管理
|
|
- 上传本地文件到网盘
|
|
|
|
## 前置要求
|
|
|
|
需要配置环境变量：
|
|
- `NETDISK_QUARK_COOKIE` — 夸克网盘 Cookie（用于夸克相关操作）
|
|
- `NETDISK_115_COOKIE` — 115 网盘 Cookie（用于 115 相关操作和离线下载）
|
|
- `PANSOU_URL` — PanSou API 地址（用于资源搜索，可选）
|
|
|
|
获取 Cookie 方法：登录对应网盘网站，打开浏览器开发者工具（F12）→ Network，复制任意请求的 `Cookie` 头。
|
|
|
|
## Usage
|
|
|
|
所有工具通过 `mcporter call netdisk.<tool>` 调用。
|
|
|
|
### 1. 浏览网盘目录
|
|
|
|
```shell
|
|
# 列出夸克根目录
|
|
mcporter call 'netdisk.list(cloud: "quark", path: "/")'
|
|
|
|
# 列出 115 网盘目录
|
|
mcporter call 'netdisk.list(cloud: "115", path: "/媒体库")'
|
|
```
|
|
|
|
### 2. 查看分享链接内容
|
|
|
|
```shell
|
|
# 查看夸克分享链接
|
|
mcporter call 'netdisk.view(share_link: "https://pan.quark.cn/s/bdbdca12824c")'
|
|
|
|
# 查看夸克分享链接（带提取码）
|
|
mcporter call 'netdisk.view(share_link: "https://pan.quark.cn/s/355379af69a8?pwd=BnxD")'
|
|
|
|
# 查看 115 分享链接，只看 mp4 文件
|
|
mcporter call 'netdisk.view(share_link: "https://115cdn.com/s/swfeyyj3zrk?password=eec5", file_pattern: "*.mp4")'
|
|
```
|
|
|
|
### 3. CP-Like 转存文件到自己的网盘
|
|
|
|
`source_pattern` 的最后一段支持通配符，类似 `cp` 命令。
|
|
|
|
```shell
|
|
# 转存分享中的所有文件到夸克 /3670 目录
|
|
mcporter call 'netdisk.transfer(share_link: "https://pan.quark.cn/s/bdbdca12824c", source_pattern: "/", target_path: "/3670")'
|
|
|
|
# 只转存 115 分享中的 mkv 文件到 /媒体库
|
|
mcporter call 'netdisk.transfer(share_link: "https://115cdn.com/s/swfry4r3zrk?password=t58d", source_pattern: "/Season 1/*.mkv", target_path: "/媒体库")'
|
|
```
|
|
|
|
### 4. 搜索资源
|
|
|
|
```shell
|
|
# 搜索夸克网盘资源
|
|
mcporter call 'netdisk.search(query: "肖申克的救赎", cloud_types: ["quark"])'
|
|
|
|
# 搜索磁力链接
|
|
mcporter call 'netdisk.search(query: "流浪地球", cloud_types: ["magnet"])'
|
|
|
|
# 高级搜索：包含/排除关键词
|
|
mcporter call 'netdisk.search(query: "电视剧", include: ["合集"], exclude: ["预告"])'
|
|
```
|
|
|
|
### 5. 115 离线下载
|
|
|
|
```shell
|
|
# 提交磁力链接到 115 离线下载
|
|
mcporter call 'netdisk.offline_download(magnet_links: ["magnet:?xt=urn:btih:xxx"], target_path: "/媒体库/云下载电影")'
|
|
```
|
|
|
|
### 6. 健康检查
|
|
|
|
```shell
|
|
# 检查 PanSou API 状态
|
|
mcporter call 'netdisk.health()'
|
|
```
|
|
|
|
## 典型工作流
|
|
|
|
```
|
|
搜索 → 查看 → 转存 / 离线下载
|
|
|
|
1. search("流浪地球", cloud_types=["quark"]) → 找到分享链接
|
|
2. view(share_link="...", file_pattern="*.mp4") → 查看有哪些文件
|
|
3. transfer(share_link="...", source_pattern="/", target_path="/3670") → 转存
|
|
|
|
1. search("电影", cloud_types=["magnet"]) → 找到磁力链接
|
|
2. offline_download(magnet_links=["..."], target_path="/媒体库/云下载电影") → 离线下载
|
|
```
|
|
|
|
## Config
|
|
|
|
当提示 MCP 服务器不存在时，执行以下命令添加配置：
|
|
|
|
```shell
|
|
mcporter config add netdisk \
|
|
--stdio "npx -y @ptbsare/netdisk-mcp-server" \
|
|
--env "NETDISK_QUARK_COOKIE=${NETDISK_QUARK_COOKIE}" \
|
|
--env "NETDISK_115_COOKIE=${NETDISK_115_COOKIE}" \
|
|
--env "PANSOU_URL=${PANSOU_URL}"
|
|
```
|
|
|
|
## 通配符模式
|
|
|
|
| 模式 | 说明 |
|
|
|------|------|
|
|
| `*` | 所有文件 |
|
|
| `*.mp4` | 所有 MP4 文件 |
|
|
| `*.mkv` | 所有 MKV 文件 |
|
|
| `S01E01*` | 以 "S01E01" 开头的文件 |
|
|
| `*2160p*` | 包含 "2160p" 的文件 |
|
|
|
|
## About `mcporter`
|
|
|
|
- When command `mcporter` does not exist, use `npx -y mcporter` instead.
|
|
- https://github.com/steipete/mcporter
|