Skills 配置说明
本文档说明 MCP Skill（skill-output/）的运行配置，内容对齐当前执行器实现。
必需变量
| 变量 | 必填 | 说明 | 默认值 |
|---|---|---|---|
API_KEY | 是 | 360 AI 云盘 API 密钥 | - |
通用变量
| 变量 | 必填 | 说明 | 默认值 |
|---|---|---|---|
ECS_ENV | 否 | 环境：prod / test | prod |
SUB_CHANNEL | 否 | 子渠道 | open |
MCP_MODE | 否 | 连接模式：http / npx / local | http |
模式变量
HTTP 模式
| 变量 | 必填 | 说明 | 默认值 |
|---|---|---|---|
MCP_HTTP_URL | 否 | MCP HTTP 端点 | https://mcp.yunpan.com/mcp |
NPX 模式
| 变量 | 必填 | 说明 | 默认值 |
|---|---|---|---|
MCP_NPX_PACKAGE | 否 | npx 启动包 | @aicloud360/360-ai-cloud-disk-cli@latest |
Local 模式
| 变量 | 必填 | 说明 | 默认值 |
|---|---|---|---|
MCP_SERVER_DIR | 否 | 本地 MCP Server 工作目录 | . |
推荐配置模板
# 鉴权
API_KEY=your_api_key_here
ECS_ENV=prod
SUB_CHANNEL=open
# 模式（推荐 http）
MCP_MODE=http
MCP_HTTP_URL=https://mcp.yunpan.com/mcp
# 可选：npx / local 模式下使用
# MCP_NPX_PACKAGE=@aicloud360/360-ai-cloud-disk-cli@latest
# MCP_SERVER_DIR=/absolute/path/to/ecs_mcp
模式说明
MCP_MODE=http（推荐）
- 优点：配置最简单，不依赖本地构建。
- 适合：大多数生产 Agent 场景。
MCP_MODE=npx
- 优点：无需手动构建本地项目。
- 代价：首次运行需要拉取 npm 包。
MCP_MODE=local
- 优点：便于本地调试和开发联调。
- 前提：本地工程已完成
npm run build。
当前实现约束
file-upload-stdio在 HTTP 模式下会自动切到 npx 执行。file-download-stdio目前不在 Skill 的工具映射中（转换配置关闭）。- 当前执行器未实现
MCP_API_KEY / MCP_ECS_ENV / MCP_SUB_CHANNEL动态覆盖变量，请使用API_KEY / ECS_ENV / SUB_CHANNEL进行配置。