@infimind/video-mcp-cli 1.0.6 → 1.0.8

package/README.md

@@ -21,7 +21,10 @@ npm install -g @infimind/video-mcp-cli
   "mcpServers": {
     "sora-video-generator": {
       "command": "npx",
-      "args": ["-y", "@infimind/video-mcp-cli", "--token=YOUR_TOKEN"]
+      "args": ["-y", "@infimind/video-mcp-cli"],
+      "env": {
+        "SORA_MCP_TOKEN": "YOUR_TOKEN"
+      }
     }
   }
 }
@@ -48,8 +51,8 @@ Add the following to your Claude Desktop configuration file:
   "mcpServers": {
     "sora-video-generator": {
       "command": "sora-mcp",
-      "args": ["--token=YOUR_TOKEN_HERE"],
       "env": {
+        "SORA_MCP_TOKEN": "YOUR_TOKEN_HERE",
         "SORA_API_URL": "https://your-api-domain.com/api"
       }
     }
@@ -59,8 +62,11 @@ Add the following to your Claude Desktop configuration file:
 
 #### Environment Variables
 
+- `SORA_MCP_TOKEN` (recommended): Your MCP API token. This avoids exposing the token in process arguments.
 - `SORA_API_URL` (optional): Your API base URL. Defaults to `http://localhost:3000/api`
 
+`--token=YOUR_TOKEN` remains supported for backward compatibility. `--token-env=CUSTOM_ENV_NAME` can be used when the token is stored in a different environment variable.
+
 ### 3. Restart Claude Desktop
 
 After saving the configuration, restart Claude Desktop for the changes to take effect.
@@ -90,13 +96,12 @@ Parameter applicability:
 
 | Parameter | S2 极睿Sa专业版 | S5 极睿Sd专业版 | S6 极睿Ha专业版 |
 | --- | --- | --- | --- |
-| `sourceImage` | Optional single image | Not recommended | Standard mode single image |
+| `sourceImage` | Optional single image | Not supported | Standard mode single image |
 | `sourceImages` | Not supported | allinone / firstlast images | reference / edit reference images |
 | `sourceVideos` | Not supported | allinone reference videos | edit input videos |
 | `sourceAudios` | Not supported | allinone reference audio | Not supported |
 | `taskMode` | Not needed | `allinone` / `firstlast` | `standard` / `reference` / `edit` |
-| `resolution` | Not supported | `480p` / `720p` / `1080p` | `720p` / `1080p` |
-| `inputDurationTier` | Not supported | `short` / `medium` / `long` | edit mode only |
+| `resolution` | Not supported | `720p` / `1080p` | `720p` / `1080p` |
 | `ratio` | Not supported | Not supported | reference or text-to-video standard mode |
 | `generateAudio` | Not supported | Optional | Not supported |
 | `webSearchEnabled` | Not supported | Optional | Not supported |
@@ -104,7 +109,26 @@ Parameter applicability:
 
 Local file paths and public URLs are both supported. Local files are converted to base64 by the MCP server before being sent to the API.
 
-Use `dryRun: true` to validate parameters, VIP access, estimated credits, and media rules without creating a task or deducting credits. The result includes `success`, `dryRun`, `route`, `engineName`, `taskMode`, `estimatedCredits`, `remainingCredits`, and `validationWarnings`.
+Video inputs support MP4/MOV. Audio inputs support MP3/WAV. The server validates media duration, size, count, resolution, and URL safety before estimating credits or creating tasks.
+
+Media limits:
+
+- Local video files: MP4/MOV, up to 50MB each, 2-15 seconds.
+- Local audio files: MP3/WAV, up to 15MB each, 2-15 seconds.
+- S5 allinone: up to 9 images, 3 videos, and 3 audio files.
+- S5 firstlast: up to 2 images; the first frame is required.
+- S6 reference: up to 9 images.
+- S6 edit: up to 1 video and 5 images.
+- `inputDurationTier` is not accepted from clients; the server calculates it from the media.
+
+URL safety rules:
+
+- Only `http` and `https` URLs are accepted.
+- `localhost`, `127.0.0.1`, private network addresses, reserved IP ranges, and `file:` URLs are rejected.
+- Redirect targets are revalidated.
+- Remote files that are too large, not media, or cannot be safely probed are rejected.
+
+Use `dryRun: true` to validate parameters, VIP access, estimated credits, and media rules without creating a task or deducting credits. The result includes `success`, `dryRun`, `route`, `engineName`, `taskMode`, `estimatedCredits`, `remainingCredits`, and `validationWarnings`. Specific credit tables are server-side only; use dry run to get the current estimated consumption.
 
 #### Dry run before creating a task
 
@@ -131,7 +155,8 @@ Use `dryRun: true` to validate parameters, VIP access, estimated credits, and me
   "seconds": 10,
   "size": "720x1280",
   "language": "zh-CN",
-  "count": 1
+  "count": 1,
+  "dryRun": true
 }
 ```
 
@@ -148,9 +173,9 @@ Use `dryRun: true` to validate parameters, VIP access, estimated credits, and me
   "seconds": 10,
   "size": "720x1280",
   "resolution": "720p",
-  "inputDurationTier": "medium",
   "generateAudio": true,
-  "webSearchEnabled": false
+  "webSearchEnabled": false,
+  "dryRun": true
 }
 ```
 
@@ -164,7 +189,8 @@ Use `dryRun: true` to validate parameters, VIP access, estimated credits, and me
   "sourceImages": ["/path/to/first-frame.jpg", "/path/to/end-frame.jpg"],
   "seconds": 5,
   "size": "1280x720",
-  "resolution": "720p"
+  "resolution": "720p",
+  "dryRun": true
 }
 ```
 
@@ -180,7 +206,8 @@ Text-to-video:
   "seconds": 5,
   "size": "1280x720",
   "ratio": "16:9",
-  "resolution": "720p"
+  "resolution": "720p",
+  "dryRun": true
 }
 ```
 
@@ -194,7 +221,8 @@ Image-to-video:
   "sourceImage": "/path/to/product.jpg",
   "seconds": 5,
   "size": "720x1280",
-  "resolution": "720p"
+  "resolution": "720p",
+  "dryRun": true
 }
 ```
 
@@ -209,7 +237,8 @@ Image-to-video:
   "seconds": 10,
   "size": "720x1280",
   "ratio": "9:16",
-  "resolution": "720p"
+  "resolution": "720p",
+  "dryRun": true
 }
 ```
 
@@ -223,11 +252,11 @@ Image-to-video:
   "sourceVideos": ["/path/to/input.mp4"],
   "sourceImages": ["/path/to/reference.jpg"],
   "resolution": "720p",
-  "inputDurationTier": "medium"
+  "dryRun": true
 }
 ```
 
-After creating a task, use `get_video_status` with the returned `taskId` to query progress and video links.
+After dry run succeeds and `estimatedCredits` looks correct, remove `dryRun` or set it to `false` to create the real task. After creating a task, use `get_video_status` with the returned `taskId` to query progress and video links.
 
 ## Development
 
@@ -246,7 +275,7 @@ npm run build
 npm run test:smoke
 
 # Run in development mode
-node dist/index.js --token=YOUR_TOKEN
+SORA_MCP_TOKEN=YOUR_TOKEN node dist/index.js
 ```
 
 ### Local MCP testing
@@ -256,7 +285,7 @@ node dist/index.js --token=YOUR_TOKEN
 ```bash
 cd mcp-server
 npm run build
-npx @modelcontextprotocol/inspector node dist/index.js --token=YOUR_TOKEN
+SORA_MCP_TOKEN=YOUR_TOKEN npx @modelcontextprotocol/inspector node dist/index.js
 ```
 
 Set `SORA_API_URL=http://localhost:3000/api` when testing against a local app server.
@@ -268,8 +297,9 @@ Set `SORA_API_URL=http://localhost:3000/api` when testing against a local app se
   "mcpServers": {
     "sora-video-generator-local": {
       "command": "node",
-      "args": ["/absolute/path/to/sora_video_generator/mcp-server/dist/index.js", "--token=YOUR_TOKEN"],
+      "args": ["/absolute/path/to/sora_video_generator/mcp-server/dist/index.js"],
       "env": {
+        "SORA_MCP_TOKEN": "YOUR_TOKEN",
         "SORA_API_URL": "http://localhost:3000/api"
       }
     }
@@ -284,8 +314,9 @@ Set `SORA_API_URL=http://localhost:3000/api` when testing against a local app se
   "mcpServers": {
     "sora-video-generator": {
       "command": "npx",
-      "args": ["-y", "@infimind/video-mcp-cli", "--token=YOUR_TOKEN"],
+      "args": ["-y", "@infimind/video-mcp-cli"],
       "env": {
+        "SORA_MCP_TOKEN": "YOUR_TOKEN",
         "SORA_API_URL": "https://your-api-domain.com/api"
       }
     }
@@ -299,16 +330,23 @@ Set `SORA_API_URL=http://localhost:3000/api` when testing against a local app se
 - If `get_video_status` cannot connect, verify `SORA_API_URL` includes `/api`, for example `http://localhost:3000/api`.
 - If S5/S6 returns VIP errors, confirm the MCP token belongs to a VIP user.
 - If S6 reference/edit prompts contain `@图片N`, keep the original markers; those modes skip prompt translation to preserve image references.
-- If local file inputs fail, use absolute paths and supported media types: jpg/png/webp/gif, mp4/mov/avi/mkv, mp3/wav/m4a/aac/ogg.
+- If local file inputs fail, use absolute paths and supported media types: jpg/png/webp/gif, mp4/mov, mp3/wav.
 
 ## Publishing
 
 ```bash
-# Build the package
+# Build and verify local dist
 npm run build
+npm run test:smoke
+
+# Verify the package contents that npm will publish
+npm run test:smoke:package
 
 # Publish to npm
 npm publish --access public
+
+# Optional after publishing: verify latest through npx
+npm run test:smoke:published
 ```
 
 ## Security

package/dist/index.js

@@ -4,23 +4,28 @@ import { createServer } from "./server.js";
 /**
  * CLI Entry Point for Sora MCP Server
  *
- * Usage: sora-mcp --token=YOUR_TOKEN
+ * Usage: sora-mcp
  *
  * Environment Variables:
+ *   SORA_MCP_TOKEN - MCP API token
  *   SORA_API_URL - API base URL (default: http://localhost:3000/api)
  */
 async function main() {
     // Parse command line arguments
     const args = process.argv.slice(2);
     const tokenArg = args.find(arg => arg.startsWith("--token="));
-    if (!tokenArg) {
-        console.error("Error: --token argument is required");
-        console.error("Usage: sora-mcp --token=YOUR_TOKEN");
+    const tokenEnvArg = args.find(arg => arg.startsWith("--token-env="));
+    const explicitTokenEnvName = tokenEnvArg?.split("=")[1];
+    const tokenEnvName = explicitTokenEnvName || "SORA_MCP_TOKEN";
+    if (tokenEnvArg && !explicitTokenEnvName) {
+        console.error("Error: --token-env value is empty");
+        console.error("Usage: sora-mcp --token-env=SORA_MCP_TOKEN");
         process.exit(1);
     }
-    const token = tokenArg.split("=")[1];
+    const tokenFromEnv = process.env[tokenEnvName];
+    const token = tokenFromEnv || tokenArg?.split("=")[1];
     if (!token) {
-        console.error("Error: Token value is empty");
+        console.error(`Error: token is required. Set ${tokenEnvName} or pass --token=YOUR_TOKEN.`);
         process.exit(1);
     }
     // Get API URL from environment variable or use default

package/dist/server.js

@@ -6,7 +6,7 @@
  */
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { readFileSync, existsSync } from "fs";
+import { readFileSync, existsSync, statSync } from "fs";
 import { extname, basename } from "path";
 import { MCP_SERVER_VERSION, getMcpDefaultTaskMode, getMcpEngineName, getMcpVideoStatusHint, isMcpRoute, isValidMcpTaskMode, } from "./videoRules.js";
 class McpToolError extends Error {
@@ -129,12 +129,7 @@ export function createServer(token, apiBaseUrl) {
                         resolution: {
                             type: "string",
                             description: "S5/S6 输出清晰度（默认：720p）",
-                            enum: ["480p", "720p", "1080p"],
-                        },
-                        inputDurationTier: {
-                            type: "string",
-                            description: "S5 或 S6 edit 模式的输入素材时长档位：short=0-4秒、medium=5-10秒、long=11-15秒（默认：short）",
-                            enum: ["short", "medium", "long"],
+                            enum: ["720p", "1080p"],
                         },
                         ratio: {
                             type: "string",
@@ -155,6 +150,7 @@ export function createServer(token, apiBaseUrl) {
                         },
                     },
                     required: ["prompt"],
+                    additionalProperties: false,
                 },
                 outputSchema: {
                     type: "object",
@@ -202,6 +198,19 @@ export function createServer(token, apiBaseUrl) {
                         progress: { type: "number" },
                         totalVideos: { type: "number" },
                         completedVideos: { type: "number" },
+                        estimatedCredits: { type: "number" },
+                        chargedVideos: { type: "number" },
+                        actualRoute: { type: "string" },
+                        taskMode: { type: ["string", "null"] },
+                        retryCount: { type: "number" },
+                        statusHint: { type: "string" },
+                        createdAt: { type: ["string", "null"] },
+                        updatedAt: { type: ["string", "null"] },
+                        completedAt: { type: ["string", "null"] },
+                        errorMessage: { type: "string" },
+                        errorCode: { type: "string" },
+                        errorCategory: { type: "string" },
+                        retryable: { type: "boolean" },
                         code: { type: "string" },
                         message: { type: "string" },
                         route: { type: "string" },
@@ -216,6 +225,14 @@ export function createServer(token, apiBaseUrl) {
                                     videoUrl: { type: ["string", "null"] },
                                     thumbnailUrl: { type: ["string", "null"] },
                                     errorMessage: { type: ["string", "null"] },
+                                    errorCode: { type: ["string", "null"] },
+                                    errorCategory: { type: ["string", "null"] },
+                                    retryable: { type: ["boolean", "null"] },
+                                    actualRoute: { type: ["string", "null"] },
+                                    retryCount: { type: "number" },
+                                    creditsCharged: { type: "boolean" },
+                                    createdAt: { type: ["string", "null"] },
+                                    completedAt: { type: ["string", "null"] },
                                 },
                                 required: ["id", "status", "videoUrl", "thumbnailUrl", "errorMessage"],
                             },
@@ -402,21 +419,23 @@ async function processFileInput(fileInput, expectedType) {
         ".webp": "image/webp",
         ".mp4": "video/mp4",
         ".mov": "video/quicktime",
-        ".avi": "video/x-msvideo",
-        ".mkv": "video/x-matroska",
         ".mp3": "audio/mpeg",
         ".wav": "audio/wav",
-        ".m4a": "audio/mp4",
-        ".aac": "audio/aac",
-        ".ogg": "audio/ogg",
     };
     if (!(ext in mimeTypes)) {
-        throw new McpToolError(`不支持的文件类型：${ext || "无扩展名"}。请使用 jpg/png/webp/gif 图片、mp4/mov/avi/mkv 视频或 mp3/wav/m4a/aac/ogg 音频。`, "UNSUPPORTED_FILE_TYPE");
+        throw new McpToolError(`不支持的文件类型：${ext || "无扩展名"}。请使用 jpg/png/webp/gif 图片、mp4/mov 视频或 mp3/wav 音频。`, "UNSUPPORTED_FILE_TYPE");
     }
     mimeType = mimeTypes[ext];
     if (expectedType && !mimeType.startsWith(`${expectedType}/`)) {
         throw new McpToolError(`文件 ${basename(filePath)} 类型不匹配：当前是 ${mimeType}，但该字段需要 ${expectedType} 文件。`, "INVALID_FILE_TYPE");
     }
+    const size = statSync(filePath).size;
+    if (expectedType === "video" && size > 50 * 1024 * 1024) {
+        throw new McpToolError(`视频文件 ${basename(filePath)} 超过 50MB 限制。`, "MEDIA_FILE_TOO_LARGE");
+    }
+    if (expectedType === "audio" && size > 15 * 1024 * 1024) {
+        throw new McpToolError(`音频文件 ${basename(filePath)} 超过 15MB 限制。`, "MEDIA_FILE_TOO_LARGE");
+    }
     // 转换为 base64
     const base64 = `data:${mimeType};base64,${buffer.toString("base64")}`;
     return {
@@ -438,6 +457,9 @@ async function processFileInputs(fileInputs, expectedType) {
 function hasItems(value) {
     return Array.isArray(value) && value.some((item) => typeof item === "string" && item.length > 0);
 }
+function itemCount(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.length > 0).length : 0;
+}
 function normalizeRoute(value) {
     const route = typeof value === "string" ? value : "S2";
     if (!isMcpRoute(route)) {
@@ -459,13 +481,6 @@ function normalizeTaskMode(route, value) {
     }
     return mode;
 }
-function normalizeInputDurationTier(value) {
-    const tier = (typeof value === "string" ? value : "short");
-    if (!["short", "medium", "long"].includes(tier)) {
-        throw new McpToolError("inputDurationTier 只能是 short、medium 或 long。");
-    }
-    return tier;
-}
 function validateCreateVideoArgs(args) {
     if (!args || typeof args !== "object") {
         throw new McpToolError("请提供视频生成参数。");
@@ -473,11 +488,19 @@ function validateCreateVideoArgs(args) {
     if (!args.prompt || typeof args.prompt !== "string" || !args.prompt.trim()) {
         throw new McpToolError("prompt 不能为空。");
     }
+    if (args.count !== undefined && (!Number.isInteger(args.count) || args.count < 1 || args.count > 12)) {
+        throw new McpToolError("count 必须是 1-12 的整数。", "INVALID_COUNT");
+    }
     const route = normalizeRoute(args.route);
     const taskMode = normalizeTaskMode(route, args.taskMode);
-    const inputDurationTier = normalizeInputDurationTier(args.inputDurationTier);
     const resolution = typeof args.resolution === "string" ? args.resolution : "720p";
     const dryRun = args.dryRun === true;
+    if (args.inputDurationTier !== undefined) {
+        throw new McpToolError("inputDurationTier 不再支持由 MCP 传入；输入视频时长档位由服务端根据素材自动计算。", "UNSUPPORTED_FIELD", route);
+    }
+    if ((route === "S5" || route === "S6") && resolution !== "720p" && resolution !== "1080p") {
+        throw new McpToolError(`${getMcpEngineName(route)} 仅支持 720p 或 1080p。`, "INVALID_RESOLUTION", route);
+    }
     if (route === "S2" && args.seconds === 5) {
         throw new McpToolError("极睿Sa专业版不支持 5 秒视频，请使用 10 或 15 秒。", "INVALID_SECONDS", route);
     }
@@ -487,7 +510,6 @@ function validateCreateVideoArgs(args) {
             hasItems(args.sourceVideos) ? "sourceVideos" : undefined,
             hasItems(args.sourceAudios) ? "sourceAudios" : undefined,
             args.resolution !== undefined ? "resolution" : undefined,
-            args.inputDurationTier !== undefined ? "inputDurationTier" : undefined,
             args.ratio !== undefined ? "ratio" : undefined,
             args.generateAudio !== undefined ? "generateAudio" : undefined,
             args.webSearchEnabled !== undefined ? "webSearchEnabled" : undefined,
@@ -509,6 +531,21 @@ function validateCreateVideoArgs(args) {
         if (taskMode === "firstlast" && (hasItems(args.sourceVideos) || hasItems(args.sourceAudios))) {
             throw new McpToolError("sourceVideos/sourceAudios 仅适用于极睿Sd专业版全能参考模式；首尾帧模式只使用 sourceImages。", "UNSUPPORTED_FIELD", route);
         }
+        if (taskMode === "firstlast" && itemCount(args.sourceImages) > 2) {
+            throw new McpToolError("极睿Sd专业版首尾帧模式最多支持 2 张图片。", "MEDIA_COUNT_EXCEEDED", route);
+        }
+        if (taskMode === "allinone" && itemCount(args.sourceImages) > 9) {
+            throw new McpToolError("极睿Sd专业版全能参考模式最多支持 9 张参考图片。", "MEDIA_COUNT_EXCEEDED", route);
+        }
+        if (taskMode === "allinone" && itemCount(args.sourceVideos) > 3) {
+            throw new McpToolError("极睿Sd专业版全能参考模式最多支持 3 个参考视频。", "MEDIA_COUNT_EXCEEDED", route);
+        }
+        if (taskMode === "allinone" && itemCount(args.sourceAudios) > 3) {
+            throw new McpToolError("极睿Sd专业版全能参考模式最多支持 3 个参考音频。", "MEDIA_COUNT_EXCEEDED", route);
+        }
+        if (taskMode === "allinone" && hasItems(args.sourceAudios) && !hasItems(args.sourceImages) && !hasItems(args.sourceVideos)) {
+            throw new McpToolError("极睿Sd专业版全能参考模式中，音频素材必须搭配至少一张参考图片或一个参考视频。", "MISSING_VISUAL_REFERENCE", route);
+        }
     }
     if (route === "S6") {
         const unsupported = [
@@ -531,12 +568,20 @@ function validateCreateVideoArgs(args) {
         if (taskMode === "edit" && !hasItems(args.sourceVideos)) {
             throw new McpToolError("极睿Ha专业版视频编辑模式需要在 sourceVideos 中提供至少 1 个参考视频。", "MISSING_SOURCE_VIDEO", route);
         }
+        if (taskMode === "reference" && itemCount(args.sourceImages) > 9) {
+            throw new McpToolError("极睿Ha专业版图片参考模式最多支持 9 张参考图片。", "MEDIA_COUNT_EXCEEDED", route);
+        }
+        if (taskMode === "edit" && itemCount(args.sourceVideos) > 1) {
+            throw new McpToolError("极睿Ha专业版视频编辑模式最多支持 1 个参考视频。", "MEDIA_COUNT_EXCEEDED", route);
+        }
+        if (taskMode === "edit" && itemCount(args.sourceImages) > 5) {
+            throw new McpToolError("极睿Ha专业版视频编辑模式最多支持 5 张参考图片。", "MEDIA_COUNT_EXCEEDED", route);
+        }
     }
     return {
         route,
         taskMode,
         resolution,
-        inputDurationTier,
         dryRun,
         statusHint: getMcpVideoStatusHint(dryRun),
     };
@@ -561,7 +606,6 @@ async function handleCreateVideoTask(apiBaseUrl, token, args) {
         taskMode: normalized.taskMode,
         isFirstLastMode: normalized.taskMode === "firstlast",
         resolution: normalized.resolution,
-        inputDurationTier: normalized.inputDurationTier,
         ratio: args.ratio || undefined,
         generateAudio: args.generateAudio,
         webSearchEnabled: args.webSearchEnabled,
@@ -627,8 +671,21 @@ async function handleGetVideoStatus(apiBaseUrl, token, args) {
         `- **任务 ID**: ${response.taskId}`,
         `- **状态**: ${statusText}`,
         `- **进度**: ${response.progress}% (${response.completedVideos}/${response.totalVideos} 个视频)`,
+        response.engineName ? `- **生成引擎**: ${response.engineName}` : undefined,
+        response.taskMode ? `- **模式**: ${response.taskMode}` : undefined,
+        response.actualRoute ? `- **实际线路**: ${response.actualRoute}` : undefined,
+        typeof response.estimatedCredits === "number" ? `- **预估积分**: ${response.estimatedCredits}` : undefined,
+        typeof response.chargedVideos === "number" ? `- **已扣费视频**: ${response.chargedVideos}/${response.totalVideos}` : undefined,
+        typeof response.retryCount === "number" ? `- **重试次数**: ${response.retryCount}` : undefined,
         ``,
-    ];
+    ].filter((line) => line !== undefined);
+    if (response.errorMessage) {
+        result.push(`- **错误**: ${response.errorMessage}`);
+        if (response.errorCode) {
+            result.push(`- **错误代码**: ${response.errorCode}`);
+        }
+        result.push(``);
+    }
     if (response.videos && response.videos.length > 0) {
         result.push(`## 视频列表:`);
         response.videos.forEach((video, index) => {
@@ -646,8 +703,23 @@ async function handleGetVideoStatus(apiBaseUrl, token, args) {
             if (video.errorMessage) {
                 result.push(`   ❌ 错误: ${video.errorMessage}`);
             }
+            if (video.errorCode) {
+                result.push(`   错误代码: ${video.errorCode}`);
+            }
+            if (video.actualRoute) {
+                result.push(`   实际线路: ${video.actualRoute}`);
+            }
+            if (typeof video.retryCount === "number" && video.retryCount > 0) {
+                result.push(`   重试次数: ${video.retryCount}`);
+            }
+            if (typeof video.creditsCharged === "boolean") {
+                result.push(`   已扣费: ${video.creditsCharged ? "是" : "否"}`);
+            }
         });
     }
+    if (response.statusHint) {
+        result.push(``, response.statusHint);
+    }
     return {
         content: [
             {
@@ -662,6 +734,21 @@ async function handleGetVideoStatus(apiBaseUrl, token, args) {
             progress: response.progress,
             totalVideos: response.totalVideos,
             completedVideos: response.completedVideos,
+            route: response.route,
+            engineName: response.engineName,
+            taskMode: response.taskMode,
+            actualRoute: response.actualRoute,
+            retryCount: response.retryCount,
+            chargedVideos: response.chargedVideos,
+            estimatedCredits: response.estimatedCredits,
+            statusHint: response.statusHint,
+            createdAt: response.createdAt,
+            updatedAt: response.updatedAt,
+            completedAt: response.completedAt,
+            errorMessage: response.errorMessage,
+            errorCode: response.errorCode,
+            errorCategory: response.errorCategory,
+            retryable: response.retryable,
             videos: response.videos || [],
         },
     };
@@ -831,7 +918,11 @@ async function callRestApi(apiBaseUrl, path, params, method = "GET") {
     const data = await response.json();
     // Check for error in response
     if (data.error) {
-        throw new Error(data.error.message || "API 返回错误");
+        const toolError = new McpToolError(data.error.message || "API 返回错误", data.error.code || "API_ERROR", data.error.route);
+        if (data.error.engineName) {
+            toolError.engineName = data.error.engineName;
+        }
+        throw toolError;
     }
     return data;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infimind/video-mcp-cli",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "MCP Server for Sora AI Video Generator - Access video generation features through Claude Desktop",
   "type": "module",
   "main": "dist/index.js",
@@ -15,7 +15,9 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "test:smoke": "node scripts/smoke-test.mjs",
-    "prepublishOnly": "npm run build"
+    "test:smoke:package": "MCP_SMOKE_TARGET=package node scripts/smoke-test.mjs",
+    "test:smoke:published": "MCP_SMOKE_TARGET=published node scripts/smoke-test.mjs",
+    "prepublishOnly": "npm run build && npm run test:smoke:package"
   },
   "keywords": [
     "mcp",