Agent Skills
返回列表
腾讯微云 MCP

腾讯微云 MCP

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @tencent-adm/tencent-drive-mcp。

技能介绍

解决的问题

当 Agent 需要读取、整理或搬运腾讯微云中的文件时，直接调用网页接口通常缺少统一协议，也容易踩中 pdir_key、两阶段上传、分块 SHA1 和 Token 鉴权等细节。微云 MCP 把这些操作收敛为一组 weiyun.* MCP Tool，让上层技能可以用结构化请求完成网盘文件管理。

工作方式

技能面向文件管理场景提供 14 个工具，覆盖 weiyun.list、weiyun.search、weiyun.download、weiyun.upload、weiyun.delete、weiyun.rename_file、weiyun.rename_dir、weiyun.create_dir、weiyun.move_file、weiyun.move_dir 和 weiyun.gen_share_link 等能力。典型流程是：

  • 先用 weiyun.list 获取目录条目和顶层 pdir_key；
  • 用 weiyun.search 或 weiyun.list_by_category 定位文件；
  • 下载时先取 file_id 和 pdir_key，再调用 weiyun.download；
  • 上传使用两阶段协议，推荐 upload_to_weiyun.py 处理 block_sha_list、SHA1 分块和 50000 重试；
  • 分享外链通过 weiyun.gen_share_link 生成，适合在浏览器中打开。

请求头需要携带 qua 与 version，认证通过 WyHeader: mcp_token= 传入。技能还提供 check_skill_update 用于版本检查。

适用边界

本技能只处理 腾讯微云网盘，不负责腾讯文档的创建或在线编辑，也不会向微信/QQ 直接发送文件；对百度、OneDrive 等其他网盘不适用。上传依赖 Python，下载、列表、分享、删除、重命名、移动和搜索通常不依赖 Python。删除目录必须传 dir_name，且应让用户再次确认；搜索结果通常不直接返回 pdir_key，后续操作需回到 weiyun.list 定位。遇到 117402、117407、1192、50000 等错误码时，应分别按 Token、授权、目录名或服务重试策略处理。

使用场景

  • Agent 需要从微云根目录列出文件并找到目标资料，为后续下载准备 file_id 和 pdir_key。
  • 把本地报告上传到微云指定文件夹，由技能处理两阶段上传、分块 SHA1 与重试。
  • 根据关键词搜索微云中的旧版本素材，生成分享外链发给协作方在浏览器打开。
  • 整理微云目录：重命名文件夹、移动文件并删除无用副本，删除目录前由用户确认。

适合人员

  • 需要让 Agent 管理微云文件的开发者，要求列出、搜索、下载、上传和整理资料。
  • 维护自动化脚本的工程师，需要把本地构建产物上传到微云并处理分块上传和重试。
  • 管理共享资料的团队成员，需要从微云搜索旧版本素材并生成可浏览器打开的外链。
  • 处理目录清理的运维人员，需要重命名、移动和删除微云目录，且删除前可确认。