腾讯微云官方 MCP 技能，提供 12 个工具实现网盘文件的完整管理，含专用上传协议与一键脚本，适合开发者与自动化场景。
说明：
## 核心用法
腾讯微云 MCP 技能通过 Model Context Protocol 暴露网盘管理能力，包含 12 个 MCP Tool：
**文件管理基础能力**
– `weiyun.list` / `weiyun.list_by_category`：按目录或分类（文档/图片/视频等）检索文件
– `weiyun.download` / `weiyun.delete` / `weiyun.upload`：核心文件操作
– `weiyun.rename_file` / `weiyun.rename_dir` / `weiyun.create_dir` / `weiyun.move_file` / `weiyun.move_dir`：目录结构管理
**分享与协同**
– `weiyun.gen_share_link`：生成带密码的短链接分享
**运维工具**
– `check_skill_update`：版本检查与更新指令获取
**上传协议特点**：采用 FTN 两阶段上传（预上传获取通道 → 分片上传），支持秒传。客户端需完成 SHA1 流式分块计算（`block_sha_list`、`check_sha`、`check_data`），服务端仅接收预计算哈希，防止服务器资源过载。提供 `upload_to_weiyun.py` 一键脚本整合完整流程。
## 显著优点
1. **官方背书**：腾讯微云原生 MCP 实现，API 稳定性与长期维护有保障
2. **完整功能覆盖**：从基础 CRUD 到分享、移动、分类检索、批量操作，覆盖 95%+ 网盘使用场景
3. **上传性能优化**：秒传机制 + 分片续传，大文件传输可靠；专用脚本内置重试与通道管理
4. **安全设计**：敏感操作（删除、分享）强制二次确认；目录权限校验防止越权访问
5. **跨平台支持**：Windows/macOS/Linux 均有适配，PowerShell/Bash 命令示例完备
6. **配额管理**：明确的错误码体系（117401 配额耗尽等），便于调用方优雅降级
## 潜在局限
1. **客户端计算负担**：上传需本地完成流式 SHA1 计算，大文件 CPU 占用较高；非标准 SHA1 算法需专用脚本
2. **认证复杂度**：需同时维护 `mcp_token` 与微云 Cookie，Token 有效期管理成本
3. **调用配额限制**：免费用户存在日调用上限（117401 错误），高频自动化场景可能触发限流
4. **平台锁定**：专用于微云生态，无法迁移至其他云存储
5. **Windows 编码陷阱**：中文文件名易乱码，必须 `chcp 65001` 前置，新手踩坑率高
## 适合人群
– **开发者/自动化工程师**：需将网盘操作集成至 CI/CD、数据备份、文档处理流水线
– **AI Agent 构建者**：为 LLM 赋予持久化文件存储与分享能力
– **跨设备文件同步用户**：结合脚本实现定时上传/下载自动化
– **团队协作场景**：批量分享、目录整理、权限管控等高频操作
## 常规风险
| 风险类型 | 说明 | 缓释建议 |
|———|——|———|
| **误删数据** | `delete` 操作不可逆，`delete_completely=true` 绕过回收站 | 强制用户二次确认；默认走回收站 |
| **隐私泄露** | `gen_share_link` 无密码时公开访问 | 默认生成 6 位随机密码；回显分享对象清单 |
| **Token 泄露** | MCP token 明文传输或写入历史记录 | 优先环境变量注入；避免 `–token` 明文参数 |
| **文件误上传** | 通配符或模糊路径导致敏感文件外泄 | 禁止自动展开；强制确认具体文件路径 |
| **中间人攻击** | `WEIYUN_MCP_URL_ALLOW_INSECURE` 绕过 HTTPS | 生产环境禁用；仅调试场景临时开启 |
| **配额耗尽** | 高频调用触发 117401 限流 | 实施指数退避；监控配额使用率 |
每日首次使用需执行 `check_skill_update` 版本检查，确保功能与协议兼容性。
会员专属
