CloudreveMCP

MCP音视频

提供方 bei123

音视频 HTTP · 远程 会话登录 社区 / 第三方 Cursor
查看接入方式

An MCP-based tool server for Cloudreve cloud storage that supports login, direct link creation, file upload, and downloading Douyin/Bilibili videos or NetEase Cloud Music before uploading them to the cloud drive, enabling automated media saving workflows in MCP clients like Cursor.

一句话选型结论

按资料字段整理

CloudreveMCP 属于音视频类 MCP 服务器,HTTP · 远程,会话登录,可直接接入 Cursor,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类音视频 传输方式HTTP · 远程 鉴权会话登录 部署方式远程部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

音视频
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

Blend Deployment MCP Cloudreve Python Cloud storage file management Video parsing and download Music download Direct link generation SSE service Cursor integration

支持客户端

适用场景

Blend DeploymentMCPCloudreve

安装与配置

HTTP · 远程 会话登录
连远程 HTTPS 端点,通常为 Streamable HTTP
http://localhost:3001/sse

把它填进客户端的 MCP 配置即可,不需要在本地安装运行时。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
转写与字幕

把音视频转成文字和字幕。

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在音视频场景里让模型直接调用外部能力的人。
  • 已经在用 Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
CloudreveMCP当前 未标注 HTTP · 远程 远程部署 有 2026-02-08
Ableton MCP B7b69a6a 16 stdio · 本地进程 本地部署 有 2026-05-17
Mini Max MCP 8 SSE · 服务端推送 远程部署 有 2026-05-18
LocalAI 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Youtube E0eb3510 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Voicemode MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

音视频
字段来自项目仓库与公开索引,中文说明由本站标注
提供方bei123上游标注的维护方 bei123
分类音视频本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · python本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验2026-02-08上游最后核验时间

详细介绍

9.3 KB
来自项目仓库与上游目录的原文,未做删改

Cloudreve MCP Server

基于 MCP(Model Context Protocol)的 Cloudreve 工具服务端(Python),供 Cursor 等 MCP 客户端调用。推荐流程:登入网盘 → 解析抖音/哔哩哔哩链接或搜索网易云音乐 → 下载视频/歌曲 → 上传到网盘(可返回直链)。使用 uv / uvx 启动。

项目结构(src 布局)```

CloudreveMCP/
├── run.py # 根目录启动脚本:uv run python run.py
├── pyproject.toml
├── README.md
├── .gitignore
└── src/
└── mcp_cloudreve/
├── init.py
├── main.py # python -m mcp_cloudreve
├── main.py # 入口逻辑,mcp.run(sse)
├── server.py # FastMCP 与工具注册
├── cloudreve.py # Cloudreve API 客户端
├── douyin.py # 抖音分享链接解析与无水印下载
├── bilibili.py # 哔哩哔哩 WBI 签名、DASH/durl 下载(参考)
└── netease.py # 网易云音乐搜索、eapi 加密、获取播放链接与下载(参考)


---

## 一、启动服务

需已安装 uv(`pip install uv` 或见官网)。

在项目根目录执行(任选其一):```bash
# 方式一:根目录启动脚本(推荐)
uv run python run.py

# 方式二:命令行入口
uv run mcp-cloudreve

# 方式三:以模块方式运行
uv run python -m mcp_cloudreve

或使用 uvx(从 PyPI 拉取并运行,无需先 clone 本仓库时可用):```bash
uvx mcp-cloudreve


- 默认监听 **3001** 端口(避免与部分环境 8000 冲突);可通过环境变量 `PORT`、`HOST` 修改。
- SSE 端点:**GET** `http://localhost:3001/sse` 建立 SSE 流;**POST** `http://localhost:3001/messages?session_id=xxx` 发送请求。平台 SSE 模板中的 **url** 填 `http://localhost:3001/sse`。

### 环境变量(可选)

| 变量 | 说明 |
|------|------|
| `PORT` | 服务端口,默认 `3001` |
| `HOST` | 监听地址,默认 `0.0.0.0` |
| `CLOUDREVE_BASE_URL` | Cloudreve API 根地址,默认 `https://cloudreve.2000gallery.art/api/v4` |

**上传大文件若出现 413 Request Entity Too Large**:
分块大小由 Cloudreve 创建会话时返回的 `chunk_size` 决定,客户端**必须**按该大小上传每个分块(不能改小),否则会报 Invalid Content-Length。413 表示**请求体超过了 Cloudreve 或反向代理(如 Nginx)的请求体上限**,需要由服务端/运维调大限制,本 MCP 无法绕过。

- **若你自建 Cloudreve 且前面有 Nginx**:在 Nginx 配置里(`http`、`server` 或 `location` 中)增加或修改:`client_max_body_size 200m;`(或更大,需 ≥ 单块大小),然后 `nginx -s reload`。
- **若使用他人提供的 Cloudreve(如 cloudreve.2000gallery.art)**:需联系站点管理员提高 API 或反向代理的请求体上限;或改用你自己能改 Nginx/配置的 Cloudreve 实例。

---

## 二、在平台中使用(含 SSE 模板)

### 1. 平台给的 SSE 模板

若平台要求填写「SSE」类型、并给出类似下面的模板,按下面方式填写即可:```json
{
  "transport": "sse",
  "url": "http://localhost:3001/sse",
  "headers": {},
  "timeout": 5,
  "sse_read_timeout": 300
}
  • url:填 http://localhost:3001/sse(端口与启动时一致,默认 3001)。
  • transport:保持 "sse"。
  • headers:一般留空 {} 即可;如需鉴权再按平台要求加。
  • timeout / sse_read_timeout:可按平台建议保留或适当调大。

服务端行为:

  • GET 你填的 url(即 /sse)→ 建立 SSE 流,返回会话 ID。
  • POST 到 /messages?session_id=xxx → 发送 JSON-RPC(会话 ID 由 GET 阶段得到)。

2. 在 Cursor 中使用

  1. 打开 Cursor 设置:File → Preferences → Cursor Settings(或 Ctrl+,),搜索 MCP。
  2. 在 MCP Servers 里添加本服务,例如在配置文件中加入(具体路径以 Cursor 文档为准,可能是 ~/.cursor/mcp.json 或项目内 .cursor/mcp.json):json { "mcpServers": { "cloudreve": { "url": "http://localhost:3001/sse" } } }

  3. 确保本仓库里的服务已用 uv run mcp-cloudreve 在本地跑起来(默认 http://localhost:3001)。

  4. 重启 Cursor 或重新加载 MCP,使新配置生效。

3. 使用方式

MCP 推荐流程(抖音/哔哩哔哩视频进网盘):

  1. 登入网盘:调用 cloudreve_login(邮箱、密码;若站点开验证码需先 cloudreve_get_captcha),拿到 access_token 与 refresh_token。
  2. (可选)查存储策略:调用 cloudreve_list_storage_policies(access_token),取要用的策略 id 作为上传时的 policy_id。
  3. 抖音链接 → 网盘:cloudreve_upload_douyin_video(access_token, douyin_share_link, policy_id, ...)。流程:解析抖音分享链接 → 下载无水印视频到临时文件 → 创建/确认文件夹 → 上传 → 删临时文件 → 返回直链。
  4. 哔哩哔哩链接 → 网盘:cloudreve_upload_bilibili_video(access_token, bilibili_share_link, policy_id, ..., cookie=...)。流程:解析 BV 号 → 获取 WBI 签名与播放地址(DASH 或 durl)→ 下载到临时文件(DASH 会合并音视频,多段会合并)→ 创建/确认文件夹 → 上传 → 删临时文件 → 返回直链。建议传 B 站 cookie:未登录时画质通常只有 360p/480p,传入登录后的 cookie 可获取 1080p 等更高画质;需要登录才能看的视频也必须传 cookie。需本机已安装 ffmpeg(DASH 音视频合并、多段合并)。
  5. 网易云音乐 → 网盘:cloudreve_upload_netease_song(access_token, keyword_or_song_id, policy_id, ...)。MCP 流程:根据关键词或歌曲 ID 搜索/获取歌曲 → 获取最佳可用音质链接(无损/极高/标准)→ 下载到临时文件 → 将封面图(JPG)嵌入音频元数据(MP3 ID3 / FLAC picture) → 创建/确认文件夹 → 上传 → 删临时文件 → 返回直链。可选传 netease_cookie 以获取更高音质(如无损);返回中含 cover_url 供展示。

其他常用能力:

  • 刷新令牌:access_token 过期时可调用 cloudreve_refresh_token(refresh_token),或在需要 token 的工具中传入 refresh_token,接口返回 401 时会自动刷新并重试。
  • 上传本地/Base64 文件:cloudreve_upload_file(本地路径或 Base64 + 目标 URI + policy_id),上传完成后会自动尝试获取直链。
  • 直链:cloudreve_create_direct_links(传入文件 URI 列表)为已有文件创建直链。
  • 创建文件夹:cloudreve_create_folder(access_token, folder_uri),如 cloudreve://my/douyin 或 cloudreve://douyin(会自动补为 cloudreve://my/douyin)。

  • 工具列表(均在「先登录」前提下使用除验证码外的接口):

  • cloudreve_get_captcha — 获取登录验证码(仅站点开启验证码时需要)
  • cloudreve_login — 密码登录,返回 access_token、refresh_token
  • cloudreve_refresh_token — 使用 refresh_token 刷新,返回新的 access_token 与 refresh_token(API 文档)
  • cloudreve_list_storage_policies — 获取当前用户可用的存储策略列表(上传时 policy_id 填返回的 id)(API 文档)
  • cloudreve_create_folder — 在网盘创建文件夹(如 cloudreve://my/douyin),祖先目录不存在会自动创建(API 文档)
  • cloudreve_create_upload_session — 创建上传会话(可传 refresh_token 以自动刷新)
  • cloudreve_upload_file_chunk — 上传单个分块(可传 refresh_token 以自动刷新)
  • cloudreve_upload_file — 上传整个文件(支持本地路径或 Base64),上传后自动获取直链(可传 refresh_token 以自动刷新)
  • cloudreve_create_direct_links — 为指定文件 URI 创建直链(可传 refresh_token 以自动刷新)
  • cloudreve_upload_douyin_video — 从抖音分享链接解析无水印视频、下载并上传到网盘,返回直链(可传 folder_uri、refresh_token、可选 target_uri)
  • cloudreve_upload_bilibili_video — 从哔哩哔哩链接解析 BV、下载视频(DASH/durl,需 ffmpeg)并上传到网盘,返回直链;建议传 cookie 以获取高画质(1080p)(可传 folder_uri、refresh_token、可选 target_uri)
  • cloudreve_upload_netease_song — MCP 流程:关键词/歌曲 ID → 获取最佳音质链接 → 下载 → 封面图嵌入音频元数据 → 上传网盘 → 返回直链;可选传 netease_cookie 以获取更高音质(可传 folder_uri、refresh_token、可选 target_uri)
  • echo / get_time — 示例工具

三、协议说明

本服务使用 SSE(Server-Sent Events)传输:

  • GET http://localhost:3001/sse → 建立 SSE 流,服务端返回会话 ID(在 SSE 事件中)。
  • POST http://localhost:3001/messages?session_id= → 发送 JSON-RPC 请求(Python MCP SDK 使用 session_id 查询参数)。

适合使用平台提供的「SSE」模板、只需填一个 url 的场景;url 填 http://localhost:3001/sse 即可。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
CloudreveMCP 怎么安装?

在客户端按下面的安装命令接入:http://localhost:3001/sse。装完在客户端配置里引用同一个包或端点。

CloudreveMCP 怎么在 Cursor 里配置?

它的传输方式是HTTP · 远程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

CloudreveMCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

CloudreveMCP 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

CloudreveMCP 支持哪些客户端?

资料标注支持 Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

CloudreveMCP 能提供哪些能力?

资料显示能力标签包括 Blend Deployment、MCP、Cloudreve、Python、Cloud storage file management、Video parsing and download。具体工具清单以官方文档为准。

CloudreveMCP 需要什么运行环境?

运行时为 python;属于远程端点,不需要在本地装运行时。

CloudreveMCP 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-02-08。