前言¶
在 Agent 工作流里，个人文件往往还在网盘里：备份、分享链接、按目录整理，都要先打开浏览器或客户端。若希望对话里直接「列目录、上传、生成外链」，需要一套稳定的网盘 API 与鉴权方式，还要把 Tool 名、参数约定写进 Skill，避免模型误触腾讯文档、本地路径或其他云盘。
下面介绍 SkillHub 上的 微云 MCP（@tencent-adm/tencent-drive-mcp）：面向 weiyun.com 微云网盘 的 MCP 文件操作技能，由腾讯微云发布，当前 SkillHub 版本 1.0.6，分类 dev-programming，标签含 requires_api_key=true（需配置 MCP Token）。
这是什么¶
微云 MCP 是一份基于通用 SKILL.md 格式的 Agent 技能包：指导模型在正确场景下调用微云 MCP Server 上的 weiyun.* 工具，并附带授权脚本、上传脚本与 API/工作流参考文档。
- 出品：腾讯微云（SkillHub 坐标
@tencent-adm/tencent-drive-mcp） - 协议：MCP（HTTP 传输），服务端地址为
https://www.weiyun.com/api/v3/mcpserver - 边界：仅处理微云网盘存储的文件；与腾讯文档（docs.qq.com）、纯本地文件、微信/QQ 直发、其他网盘无关（技能内对这类需求有明确负向排除说明）
SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/tencent-drive-mcp
技能包 API：https://api.skillhub.cn/tencent-adm/tencent-drive-mcp
核心功能¶
技能说明中归纳的能力如下（经 SkillHub 简介与技能包 SKILL.md 核对）。
MCP Tool（共 14 个）¶
| 工具名 | 作用 |
|---|---|
weiyun.list |
目录列表 |
weiyun.list_by_category |
按分类拉取 |
weiyun.recent_list |
最近访问 |
weiyun.search |
搜索 |
weiyun.download |
批量获取下载信息 |
weiyun.delete |
批量删除 |
weiyun.upload |
两阶段上传 |
weiyun.gen_share_link |
生成分享外链 |
weiyun.rename_file / weiyun.rename_dir |
重命名文件/目录 |
weiyun.create_dir |
创建文件夹 |
weiyun.move_file / weiyun.move_dir |
移动文件/目录 |
check_skill_update |
检查技能版本更新 |
调用时需在 req_header 中携带 qua 与 version；HTTP 认证头为 WyHeader: mcp_token=<token>。
上传与 FTN 协议¶
- 上传可走 MCP 两阶段流程；技能推荐使用一键脚本
scripts/upload_to_weiyun.py。 - 大文件 FTN 上传需要 SHA1 分块（
block_sha_list）；技能提供scripts/gen_block_info_list.py等脚本，上传协议细节见包内references/upload_protocol.md。
触发与排除（Agent 路由）¶
正向触发：用户提到「微云」「weiyun」「微云网盘」，或调用 weiyun.list / weiyun.upload / weiyun.download / weiyun.gen_share_link / weiyun.recent_list / weiyun.search 等，或提及 block_sha_list、FTN 上传。
不应触发：腾讯文档在线编辑、与微云无关的本地文件操作、向微信/QQ 联系人或群直接发文件、百度网盘/OneDrive 等；用户明确不用微云时应停用本技能。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
按 SkillHub 安装文档 检查 CLI：
command -v skillhub && skillhub --version
未安装时可执行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装微云 MCP 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向 Agent 识别的 skills 路径，否则默认落在 ./skills/ 可能无法加载。
skillhub install tencent-drive-mcp --namespace tencent-adm --dir <你的 skills 目录>
常见路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
也可将下面提示交给 AI，让其按官方流程安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/tencent-drive-mcp`。
3、配置 MCP 鉴权（mcporter + Token）¶
技能依赖 mcporter 连接微云 MCP Server。在技能包目录下，先做授权检查：
bash ./setup.sh weiyun_check_and_start_auth
- 输出
READY：可直接调用工具。 - 输出
AUTH_REQUIRED:<url>：在浏览器用 QQ/微信完成授权，用户确认后再执行：
bash ./setup.sh weiyun_fetch_token
成功时输出 TOKEN_READY。若已有 Token，也可在 微云 OpenClaw 活动页 获取后写入：
bash ./setup.sh weiyun_set_token <你的Token>
或手动配置 mcporter（与 references/auth.md 一致）：
mcporter config add weiyun "https://www.weiyun.com/api/v3/mcpserver" \
--header "WyHeader=mcp_token=$Token" \
--transport http \
--scope home
Windows 下将 bash ./setup.sh 替换为 powershell -ExecutionPolicy Bypass -File setup.ps1。
4、上传相关环境¶
- 上传需要 Python 3 与
requests（pip install requests）。 - 列表、下载、分享、删除、重命名、移动、搜索等可不依赖 Python。
典型用法¶
用 mcporter 列目录¶
在 mcporter 已配置 weiyun 的前提下：
mcporter call --server weiyun --tool weiyun.list limit=50 order_by=2 --output json
注意：须使用 --server weiyun --tool weiyun.xxx，避免把 server 与 tool 名拼错。
列出根目录（JSON 请求体示例）¶
技能文档中的 weiyun.list 示例：
{"limit": 50, "get_type": 0, "req_header": {"qua": "MAC_15.4.1_CODEBUDDY_4.8.1", "version": "1.0.8"}}
qua 按实际客户端平台与版本填写；version 与当前技能 frontmatter 版本一致。
上传本地文件¶
推荐在技能包目录执行：
python3 scripts/upload_to_weiyun.py /path/to/file --pdir_key <pdir_key>
--token 可显式传入，或设置环境变量 WEIYUN_MCP_TOKEN。pdir_key 应使用 weiyun.list 响应顶层的 pdir_key，不要用单个条目里可能为空的字段。
下载与分享¶
weiyun.list取得file_id与顶层pdir_key。weiyun.download拿到 HTTPS 地址后，用curl落盘，并核对文件大小与file_size。weiyun.gen_share_link生成外链；file_list中的pdir_key必须非空。分享链接无法用本技能直接当下载接口，需在浏览器打开。
更完整的九类工作流见包内 references/workflows.md；参数表见 references/mcp_api.md。
适用场景与注意¶
适合谁
- 已在用微云网盘存个人/团队文件，希望在 Cursor、Claude Code、Codex 等 Agent 里用自然语言或 Tool 调用完成网盘操作。
- 需要脚本化 FTN 分块上传、批量整理目录、生成带密码的分享链。
限制与坑
| 事项 | 说明 |
|---|---|
| 产品边界 | 微云网盘 ≠ 腾讯文档；IM 直发文件不支持，可改用 weiyun.gen_share_link |
| 删除目录 | dir_name 必填，且技能要求删除目录前必须让用户再次确认 |
| 搜索后续操作 | 搜索结果不含 pdir_key，需再用 weiyun.list 定位 |
| 错误码 | 如 117402 Token 无效、1192 目录名无效、50000 服务繁忙等，见 references/faq.md |
| SkillHub 数据 | 页面显示评分 100000、下载约 2433 次（以 SkillHub 为准） |
结尾¶
微云 MCP 把 weiyun.com 网盘 的文件操作收敛到 MCP Tool 与一套授权/上传脚本里，并写清触发边界，减少 Agent 误用其他产品或本地路径。若你的文件在微云且 Agent 已支持 SkillHub 安装，可按上文装好技能、完成 Token 配置后，从 weiyun.list 或上传脚本开始验证。
官方入口：https://api.skillhub.cn/tencent-adm/tencent-drive-mcp
