Skill 模式介绍
Skill 模式是一种更高效的与 360 AI云盘 MCP Server 交互的方式，通过将 MCP 工具转换为 Claude Skill 格式，可以显著减少 Token 消耗。
快速开始
1. 获取 Skill
直接下载指定版本的 Skill 压缩包：
- 下载地址：360-cloud-disk-skill-v0.7.5.zip
- 解压到对应平台的
~/skills目录下：
# macOS/Linux
cd ~ && mkdir -p skills
cd skills
unzip ~/Downloads/360-cloud-disk-skill-v0.7.5.zip
# Windows
# 解压到 C:\Users\你的用户名\skills 目录
2. 配置环境变量
编辑 skill-output/.env 文件：
# 必需的 API 密钥
API_KEY=your-api-key-here
# 环境配置
ECS_ENV=prod # 或 test
SUB_CHANNEL=open
# 连接模式（推荐 HTTP）
MCP_MODE=http
MCP_HTTP_URL=https://mcp.yunpan.com/mcp
3. 部署到 Claude Desktop
# 复制 Skill 到 Claude Skills 目录
cp -r ~/skills/360-cloud-disk-skill-v0.7.5 ~/.claude/skills/360-cloud-disk
# 重启 Claude Desktop
4. 测试连接
在 Claude Desktop 中直接使用：
请帮我查看云盘根目录的文件列表
为什么使用 Skill 模式？
Token 节省效果
| 工具数量 | MCP 模式 | Skill 模式 | 节省比例 |
|---|---|---|---|
| 12 个工具 | ~8k tokens | ~2k tokens | 75% |
| 20 个工具 | ~15k tokens | ~3k tokens | 80% |
| 30 个工具 | ~25k tokens | ~5k tokens | 80% |
核心优势
- 大幅降低成本：减少 75% 以上的 Token 消耗
- 更快的响应速度：减少上下文传输时间
- 更简洁的交互：工具描述更精简，易于理解
- 灵活的部署：支持多种连接模式（HTTP、npx、local）
工作原理
Skill 模式通过以下方式工作：
- 元数据精简：只保留工具的核心描述，去除冗余信息
- 延迟加载：工具详细参数在需要时才加载
- 外部执行：通过 Python 执行器调用 MCP Server，不占用上下文
┌─────────────┐
│ Claude │
└──────┬──────┘
│
│ 1. 调用 Skill
▼
┌─────────────┐
│ SKILL.md │ ← 精简的工具描述 (~100 tokens)
└──────┬──────┘
│
│ 2. 执行工具
▼
┌─────────────┐
│ executor.py │ ← Python 执行器
└──────┬──────┘
│
│ 3. 调用 MCP Server
▼
┌─────────────┐
│ MCP Server │ ← 实际执行
└─────────────┘
支持的工具
Skill 模式支持以下 360 AI云盘工具：
查询类工具
- file-list - 获取文件列表
- file-search - 搜索文件
- user-info - 获取用户信息
- get-download-url - 获取下载链接
操作类工具
- file-save - 保存文件
- file-share - 分享文件
- file-move - 移动文件
- file-rename - 重命名文件
- make-dir - 创建目录
连接模式
Skill 支持三种连接模式，通过 MCP_MODE 环境变量配置：
HTTP 模式（推荐）
最简单的配置方式，无需本地安装 MCP Server。
MCP_MODE=http
MCP_HTTP_URL=https://mcp.yunpan.com/mcp
优势：
- 配置最简单
- 无需本地安装 Node.js
- 适合生产环境
- 支持动态鉴权
npx 模式
使用 npx 从 npm 下载并运行 MCP Server。
MCP_MODE=npx
MCP_NPX_PACKAGE=@qihoo360/ecs-mcp-server
前提条件：
- Node.js >= 21.0.0
- 网络连接（用于下载 npm 包）
local 模式
本地运行 MCP Server，适合开发调试。
MCP_MODE=local
MCP_SERVER_DIR=/path/to/ecs_mcp
前提条件：
- 已构建 MCP Server（
npm run build） - Node.js >= 21.0.0
使用示例
查看文件列表
请列出云盘根目录的文件
搜索文件
搜索包含"报告"的文档文件
创建目录
在云盘根目录创建一个名为"工作文档"的文件夹
保存文件
将这个文档保存到云盘的"工作文档"文件夹中
分享文件
分享云盘中的"年度报告.pdf"文件
动态鉴权
Skill 模式支持多用户场景的动态鉴权，通过环境变量覆盖实现：
# 用户1调用
MCP_API_KEY=user1_key python3 executor.py user-info
# 用户2调用
MCP_API_KEY=user2_key python3 executor.py file-list path=/
详细配置说明请参考 配置说明。
注意事项
- 文件路径必须以
/开头 - 文件夹路径必须以
/结尾 - 多个文件用
|分隔 - HTTP 模式下，鉴权信息通过 HTTP Header 传递，不暴露在 URL 中
下一步
- 使用说明 - 详细的环境变量和连接模式配置
- 工具参数 - 所有工具的详细参数说明
- MCP Server 文档 - MCP Server 的完整文档