@szc-ft/mcp-szcd-client 0.28.1 → 0.29.0

package/standard-skill/local-browser-test/package.json

@@ -0,0 +1 @@
+{"type": "module"}

package/standard-skill/szcd-upload-zip/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: szcd-upload-zip
+description: |
+    本地 ZIP 文件上传与解压工具。将用户本地的 zip 压缩包通过 `upload-zip` REST 端点上传到 szcd-mcp-server，
+    自动解压到服务器的 `uploads/<zip包名>/` 目录，并返回解压后的文件列表。
+    上传后解压的文件可通过文件下载接口按路径获取或供其他流程使用。
+compatibility:
+  tools:
+    - run_command
+  runtime:
+    - node >= 18（读取配置用，仅 `cat ~/.szcd-mcp-config.json` 场景）
+    - curl（文件上传所需）
+---
+
+# ZIP 上传与解压工具（szcd-upload-zip）
+
+## 概述
+
+当 AI 需要将用户本地的 ZIP 压缩包上传到 szcd-mcp-server 时，使用此技能。
+上传后服务器自动解压，开发者或 AI 可通过下载 API 访问解压后的文件。
+
+## 适用场景
+
+- 用户有一个本地 zip 包需要上传到服务器存储
+- zipped 源码/资源包需要上传到服务器供后续流程使用
+- 需要在服务器端解压 zip 并取用其中的文件
+
+## 工作流
+
+### 第 0 步：探测运行时
+
+```bash
+node --version 2>/dev/null && echo "NODE_OK"; \
+curl --version 2>/dev/null | head -1 && echo "CURL_OK"
+```
+
+### 第 1 步：读取配置获取服务器地址和 API Key
+
+```bash
+cat ~/.szcd-mcp-config.json
+```
+
+配置示例：
+```json
+{
+  "MCP_SERVER_URL": "http://localhost:3456",
+  "MCP_TIMEOUT": 30000,
+  "MCP_API_KEY": "your-api-key"
+}
+```
+
+- 若 `MCP_API_KEY` 为空字符串，则上传时不带 `X-API-Key` header
+- 若 `MCP_SERVER_URL` 未配置，默认使用 `http://localhost:3456`
+
+### 第 2 步：上传 ZIP 文件
+
+```bash
+# 从 ~/.szcd-mcp-config.json 取 URL 和 API Key
+MCP_URL=$(node -e "const c=require('fs').readFileSync(require('os').homedir()+'/.szcd-mcp-config.json','utf8');const j=JSON.parse(c);console.log(j.MCP_SERVER_URL||'http://localhost:3456')")
+MCP_KEY=$(node -e "const c=require('fs').readFileSync(require('os').homedir()+'/.szcd-mcp-config.json','utf8');const j=JSON.parse(c);console.log(j.MCP_API_KEY||'')")
+
+# 上传 zip 文件
+if [ -n "$MCP_KEY" ]; then
+  curl -s -X POST "$MCP_URL/upload-zip" -H "X-API-Key: $MCP_KEY" -F "file=@<zip文件路径>"
+else
+  curl -s -X POST "$MCP_URL/upload-zip" -F "file=@<zip文件路径>"
+fi
+```
+
+其中 `<zip文件路径>` 替换为实际 zip 文件的绝对路径。
+
+**响应示例：**
+```json
+{
+  "ok": true,
+  "dir_name": "my-package",
+  "extract_dir": "/scity/zengzhijie/mcp/uploads/my-package",
+  "file_count": 5,
+  "files": [
+    { "path": "index.html", "size": 2048 },
+    { "path": "js/app.js", "size": 15360 },
+    { "path": "css/style.css", "size": 4096 },
+    { "path": "images/logo.png", "size": 819200 },
+    { "path": "data/config.json", "size": 512 }
+  ]
+}
+```
+
+### 第 3 步：查看解压后的文件
+
+上传成功后，可通过下载 API 查看解压后的文件或取单个文件内容：
+
+```bash
+# 列出解压目录
+curl -s "$MCP_URL/api/download/list?dir=/scity/zengzhijie/mcp/uploads/my-package" \
+  ${MCP_KEY:+-H "X-API-Key: $MCP_KEY"}
+
+# 下载单个文件
+curl -s "$MCP_URL/api/download?path=/scity/zengzhijie/mcp/uploads/my-package/data/config.json" \
+  ${MCP_KEY:+-H "X-API-Key: $MCP_KEY"}
+```
+
+## 限制说明
+
+- 仅支持真正的 ZIP 格式（magic number `PK\x03\x04` 校验），改扩展名无用
+- 单文件大小上限 100MB
+- 同名 zip 包名会覆盖服务器上已有的目录
+- 解压后文件持久存储，无自动过期
+- 上传路径始终为 `/upload-zip`（不含 `/api/` 前缀）
+
+## 完整命令示例（一步完成）
+
+```bash
+# 读取配置
+MCP_URL=$(node -e "try{const c=require('fs').readFileSync(require('os').homedir()+'/.szcd-mcp-config.json','utf8');const j=JSON.parse(c);console.log(j.MCP_SERVER_URL||'http://localhost:3456')}catch{console.log('http://localhost:3456')}")
+MCP_KEY=$(node -e "try{const c=require('fs').readFileSync(require('os').homedir()+'/.szcd-mcp-config.json','utf8');const j=JSON.parse(c);console.log(j.MCP_API_KEY||'')}catch{console.log('')}")
+
+# 上传
+curl -s -X POST "$MCP_URL/upload-zip" \
+  ${MCP_KEY:+-H "X-API-Key: $MCP_KEY"} \
+  -F "file=@/path/to/archive.zip" | python3 -m json.tool
+```