@infimind/video-mcp-cli 1.0.9 → 1.0.11

package/README.md

@@ -100,6 +100,8 @@ Parameter applicability:
 | `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 |
+| `sourceVideoDurationSeconds` | Not supported | dryRun estimate for videos | dryRun estimate for edit video |
+| `sourceAudioDurationSeconds` | Not supported | dryRun estimate for audio | Not supported |
 | `taskMode` | Not needed | `allinone` / `firstlast` | `standard` / `reference` / `edit` |
 | `resolution` | Not supported | `720p` / `1080p` | `720p` / `1080p` |
 | `ratio` | Not supported | Not supported | reference or text-to-video standard mode |
@@ -107,7 +109,7 @@ Parameter applicability:
 | `webSearchEnabled` | Not supported | Optional | Not supported |
 | `dryRun` | Optional preflight | Optional preflight | Optional preflight |
 
-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.
+Local file paths and public URLs are both supported.
 
 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.
 
@@ -119,22 +121,21 @@ Media limits:
 - 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.
+- Remote files that are too large, not media, or cannot be read safely 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.
+Use `dryRun: true` to validate parameters, VIP access, media rules, and estimated credits without creating a task or deducting credits. If a dry run includes video or audio, add `sourceVideoDurationSeconds` / `sourceAudioDurationSeconds` to get an estimated credit result. If these duration fields are omitted, dry run can still pass, but the result may not include `estimatedCredits`.
 
 #### Dry run before creating a task
 
 ```json
 {
-  "prompt": "@图片1 作为角色参考，生成自然的走秀镜头",
+  "prompt": "@image1 作为角色参考，生成自然的走秀镜头",
   "route": "S6",
   "taskMode": "reference",
   "sourceImages": ["/path/to/character.jpg"],
@@ -172,6 +173,8 @@ S2 uses `sourceImage`, `seconds`, and `size`; do not pass `taskMode` or `resolut
   "sourceImages": ["/path/to/reference.jpg"],
   "sourceVideos": ["/path/to/reference.mp4"],
   "sourceAudios": ["/path/to/music.mp3"],
+  "sourceVideoDurationSeconds": [5],
+  "sourceAudioDurationSeconds": [5],
   "seconds": 10,
   "size": "720x1280",
   "resolution": "720p",
@@ -232,7 +235,7 @@ Image-to-video:
 
 ```json
 {
-  "prompt": "@图片1 和 @图片2 作为角色参考，生成自然的走秀镜头",
+  "prompt": "@image1 和 @image2 作为角色参考，生成自然的走秀镜头",
   "route": "S6",
   "taskMode": "reference",
   "sourceImages": ["/path/to/character-1.jpg", "/path/to/character-2.jpg"],
@@ -253,12 +256,13 @@ Image-to-video:
   "taskMode": "edit",
   "sourceVideos": ["/path/to/input.mp4"],
   "sourceImages": ["/path/to/reference.jpg"],
+  "sourceVideoDurationSeconds": [5],
   "resolution": "720p",
   "dryRun": true
 }
 ```
 
-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.
+After dry run succeeds and the estimated credits look 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
 
@@ -331,7 +335,7 @@ Set `SORA_API_URL=http://localhost:3000/api` when testing against a local app se
 - If a client reports schema mismatch, run `npm run build` and `npm run test:smoke` in `mcp-server`.
 - 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 S6 reference/edit prompts contain canonical `@imageN` markers, keep the original markers; those modes skip prompt translation to preserve image references. Legacy `@图片N` markers are still accepted and normalized by the server.
 - If local file inputs fail, use absolute paths and supported media types: jpg/png/webp/gif, mp4/mov, mp3/wav.
 
 ## Publishing

package/dist/server.js

@@ -8,7 +8,7 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { readFileSync, existsSync, statSync } from "fs";
 import { extname, basename } from "path";
-import { MCP_SERVER_VERSION, getMcpDefaultTaskMode, getMcpEngineName, getMcpVideoStatusHint, isMcpRoute, isValidMcpTaskMode, } from "./videoRules.js";
+import { MCP_SERVER_VERSION, getMcpDefaultTaskMode, getMcpEngineName, getMcpVideoStatusHint, isMcpRoute, isValidMcpTaskMode, isMcpModel, MCP_VIDEO_MODELS, } from "./videoRules.js";
 class McpToolError extends Error {
     code;
     route;
@@ -67,8 +67,7 @@ export function createServer(token, apiBaseUrl) {
                 name: "create_video_task",
                 title: "创建视频生成任务",
                 description: "创建视频生成任务。支持本地文件路径或公网 URL 作为参考图片。" +
-                    "支持极睿Sd专业版和极睿Ha专业版的多模态素材输入。" +
-                    "提示词会根据目标语言自动翻译和优化。",
+                    "支持极睿Sd专业版和极睿Ha专业版的多模态素材输入。",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -78,23 +77,33 @@ export function createServer(token, apiBaseUrl) {
                         },
                         sourceImage: {
                             type: "string",
-                            description: "可选的单张参考图片。S2 使用此字段；S6 标准模式可用作单图图生视频。可以是本地文件路径或公网 URL，本地文件会被自动转换为 base64",
+                            description: "可选的单张参考图片。S2 使用此字段；S6 标准模式可用作单图图生视频。可以是本地文件路径或公网 URL",
                         },
                         sourceImages: {
                             type: "array",
-                            description: "S5/S6 多张参考图片。本地文件路径或公网 URL 数组；本地文件会被自动转换为 base64。S5 首尾帧模式下第1张为首帧、第2张为尾帧；S6 reference/edit 模式作为参考图",
+                            description: "S5/S6 多张参考图片。本地文件路径或公网 URL 数组。S5 首尾帧模式下第1张为首帧、第2张为尾帧；S6 reference/edit 模式作为参考图",
                             items: { type: "string" },
                         },
                         sourceVideos: {
                             type: "array",
-                            description: "S5 全能参考或 S6 视频编辑模式的视频素材。本地文件路径或公网 URL 数组；本地文件会被自动转换为 base64",
+                            description: "S5 全能参考或 S6 视频编辑模式的视频素材。本地文件路径或公网 URL 数组",
                             items: { type: "string" },
                         },
                         sourceAudios: {
                             type: "array",
-                            description: "S5 全能参考模式的音频素材。本地文件路径或公网 URL 数组；本地文件会被自动转换为 base64",
+                            description: "S5 全能参考模式的音频素材。本地文件路径或公网 URL 数组",
                             items: { type: "string" },
                         },
+                        sourceVideoDurationSeconds: {
+                            type: "array",
+                            description: "可选。dryRun 使用的视频素材时长秒数数组，顺序与 sourceVideos 一致；用于获得预估积分",
+                            items: { type: "number" },
+                        },
+                        sourceAudioDurationSeconds: {
+                            type: "array",
+                            description: "可选。dryRun 使用的音频素材时长秒数数组，顺序与 sourceAudios 一致；用于获得预估积分",
+                            items: { type: "number" },
+                        },
                         size: {
                             type: "string",
                             description: "视频方向/比例。S2 支持横竖屏；S5/S6 还支持正方形、4:3、3:4（默认：1280x720）",
@@ -116,10 +125,16 @@ export function createServer(token, apiBaseUrl) {
                             minimum: 1,
                             maximum: 12,
                         },
+                        model: {
+                            type: "string",
+                            description: "生成引擎短码（推荐）：SA=极睿Sa专业版（默认，Sora 2，失败自动回退 S4）、SD=极睿Sd专业版（Seedance 2.0）、HA=极睿Ha专业版（HappyHorse 1.1）。注意：SD、HA 仅限 VIP 用户使用",
+                            enum: ["SA", "SD", "HA"],
+                        },
                         route: {
                             type: "string",
-                            description: "使用的生成引擎：S2=极睿Sa专业版（默认）、S5=极睿Sd专业版、S6=极睿Ha专业版。注意：S5、S6 仅限 VIP 用户使用",
+                            description: "内部线路代码（已废弃，请改用 model）。兼容老客户端：S2=极睿Sa专业版、S5=极睿Sd专业版、S6=极睿Ha专业版",
                             enum: ["S2", "S5", "S6"],
+                            deprecated: true,
                         },
                         taskMode: {
                             type: "string",
@@ -157,12 +172,15 @@ export function createServer(token, apiBaseUrl) {
                     properties: {
                         success: { type: "boolean" },
                         taskId: { type: "number" },
+                        model: { type: "string" },
                         route: { type: "string" },
                         engineName: { type: "string" },
+                        usedRouteAlias: { type: "boolean" },
                         taskMode: { type: "string" },
                         videoCount: { type: "number" },
                         dryRun: { type: "boolean" },
                         estimatedCredits: { type: "number" },
+                        estimateSource: { type: "string" },
                         remainingCredits: { type: "number" },
                         statusHint: { type: "string" },
                         validationWarnings: {
@@ -199,10 +217,7 @@ export function createServer(token, apiBaseUrl) {
                         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"] },
@@ -228,9 +243,6 @@ export function createServer(token, apiBaseUrl) {
                                     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"] },
                                 },
@@ -245,13 +257,13 @@ export function createServer(token, apiBaseUrl) {
                 name: "create_video_analysis_task",
                 title: "创建视频拆解任务",
                 description: "创建视频拆解任务，将视频拆解为脚本、风格、卖点话术、爆款公式，并生成用于视频创作的提示词。" +
-                    "支持本地文件路径或公网 URL 作为视频文件。本地文件会被自动转换为 base64。",
+                    "支持本地文件路径或公网 URL。",
                 inputSchema: {
                     type: "object",
                     properties: {
                         videoFile: {
                             type: "string",
-                            description: "要分析的视频文件 - 可以是本地文件路径（如 /path/to/video.mp4）或公网 URL。本地文件会被自动转换为 base64",
+                            description: "要分析的视频文件，可以是本地文件路径或公网 URL",
                         },
                     },
                     required: ["videoFile"],
@@ -361,8 +373,8 @@ async function handleGetUserInfo(apiBaseUrl, token) {
         `# 用户信息`,
         ``,
         `- **用户名**: ${response.username}`,
-        `- **姓名**: ${response.name || "N/A"}`,
-        `- **邮箱**: ${response.email || "N/A"}`,
+        `- **姓名**: ${response.name || "未提供"}`,
+        `- **邮箱**: ${response.email || "未提供"}`,
         `- **角色**: ${response.role === "admin" ? "管理员" : "用户"}`,
         `- **积分**: ${response.credits}`,
         `- **VIP 状态**: ${response.isVip ? "是" : "否"}`,
@@ -460,12 +472,27 @@ function hasItems(value) {
 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";
+function normalizeRoute(args) {
+    // 优先 model；若 model 未传或不是 SA/SD/HA，再看 route（route 现在是 deprecated alias）
+    if (args && typeof args === "object" && isMcpModel(args.model)) {
+        const m = args.model;
+        return {
+            route: MCP_VIDEO_MODELS[m].route,
+            model: m,
+            usedRouteAlias: false,
+        };
+    }
+    const raw = args && typeof args === "object" ? args.route : undefined;
+    const route = typeof raw === "string" ? raw : "S2";
     if (!isMcpRoute(route)) {
-        throw new McpToolError("route 只能是 S2、S5 或 S6。S2=极睿Sa专业版，S5=极睿Sd专业版，S6=极睿Ha专业版。", "INVALID_ROUTE");
+        throw new McpToolError("model 必须是 SA、SD 或 HA；route 只接受 S2、S5、S6（已废弃），请改用 model。", "INVALID_ENGINE");
     }
-    return route;
+    const m = route === "S2" ? "SA" : route === "S5" ? "SD" : "HA";
+    return {
+        route,
+        model: m,
+        usedRouteAlias: true,
+    };
 }
 function normalizeTaskMode(route, value) {
     const mode = typeof value === "string" ? value : getMcpDefaultTaskMode(route);
@@ -491,13 +518,11 @@ function validateCreateVideoArgs(args) {
     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 norm = normalizeRoute(args);
+    const route = norm.route;
     const taskMode = normalizeTaskMode(route, args.taskMode);
     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);
     }
@@ -580,6 +605,8 @@ function validateCreateVideoArgs(args) {
     }
     return {
         route,
+        model: norm.model,
+        usedRouteAlias: norm.usedRouteAlias,
         taskMode,
         resolution,
         dryRun,
@@ -602,6 +629,7 @@ async function handleCreateVideoTask(apiBaseUrl, token, args) {
         seconds: args.seconds || 10,
         language: args.language || "zh-CN",
         count: args.count || 1,
+        model: normalized.model,
         route: normalized.route,
         dryRun: normalized.dryRun,
     };
@@ -615,6 +643,10 @@ async function handleCreateVideoTask(apiBaseUrl, token, args) {
         requestBody.ratio = args.ratio || undefined;
         requestBody.generateAudio = args.generateAudio;
         requestBody.webSearchEnabled = args.webSearchEnabled;
+        if (normalized.dryRun) {
+            requestBody.sourceVideoDurationSeconds = args.sourceVideoDurationSeconds;
+            requestBody.sourceAudioDurationSeconds = args.sourceAudioDurationSeconds;
+        }
     }
     const response = await callRestApi(apiBaseUrl, "/mcp/video/create", requestBody, "POST");
     const route = response.route || normalized.route;
@@ -630,9 +662,11 @@ async function handleCreateVideoTask(apiBaseUrl, token, args) {
         `- **模式**: ${taskMode}`,
         `- **消息**: ${response.message}`,
         `- **生成视频数量**: ${response.videoCount}`,
-        `- **预估积分**: ${estimatedCredits ?? "N/A"}（视频完成后按成功扣费）`,
         `- **当前积分**: ${response.remainingCredits}`,
     ];
+    if (typeof estimatedCredits === "number") {
+        result.splice(6, 0, `- **预估积分**: ${estimatedCredits}（视频完成后按成功扣费）`);
+    }
     if (!dryRun && response.taskId !== undefined) {
         result.splice(4, 0, `- **任务 ID**: ${response.taskId}`);
     }
@@ -650,12 +684,15 @@ async function handleCreateVideoTask(apiBaseUrl, token, args) {
         structuredContent: {
             success: response.success,
             taskId: response.taskId,
+            model: response.model ?? normalized.model,
             route,
             engineName,
+            usedRouteAlias: normalized.usedRouteAlias,
             taskMode,
             videoCount: response.videoCount,
             dryRun,
             estimatedCredits,
+            estimateSource: response.estimateSource,
             remainingCredits: response.remainingCredits,
             statusHint,
             validationWarnings: response.validationWarnings || [],
@@ -679,10 +716,7 @@ async function handleGetVideoStatus(apiBaseUrl, token, args) {
         `- **进度**: ${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) {
@@ -712,15 +746,6 @@ async function handleGetVideoStatus(apiBaseUrl, token, args) {
             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) {
@@ -743,9 +768,6 @@ async function handleGetVideoStatus(apiBaseUrl, token, args) {
             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,

package/dist/videoRules.d.ts

@@ -1,6 +1,6 @@
 export type McpRoute = "S2" | "S5" | "S6";
 export type McpTaskMode = "allinone" | "firstlast" | "standard" | "reference" | "edit";
-export declare const MCP_SERVER_VERSION = "1.0.9";
+export declare const MCP_SERVER_VERSION = "1.0.10";
 export declare const MCP_VIDEO_STATUS_HINT = "\u4EFB\u52A1\u5DF2\u521B\u5EFA\u540E\uFF0C\u4F7F\u7528 get_video_status \u5E76\u4F20\u5165 taskId \u67E5\u8BE2\u751F\u6210\u8FDB\u5EA6\u548C\u89C6\u9891\u94FE\u63A5\u3002";
 export declare const MCP_VIDEO_DRY_RUN_HINT = "dryRun \u4EC5\u5B8C\u6210\u53C2\u6570\u3001\u6743\u9650\u3001\u79EF\u5206\u548C\u7D20\u6750\u89C4\u5219\u9884\u68C0\uFF0C\u4E0D\u4F1A\u521B\u5EFA\u4EFB\u52A1\u6216\u6263\u8D39\u3002";
 export declare const MCP_VIDEO_ENGINES: Record<McpRoute, {
@@ -14,4 +14,36 @@ export declare function getMcpEngineName(route: string): string;
 export declare function getMcpTaskModel(route: McpRoute): string;
 export declare function getMcpDefaultTaskMode(route: McpRoute, isFirstLastMode?: boolean): McpTaskMode;
 export declare function isValidMcpTaskMode(route: McpRoute, taskMode: string): taskMode is McpTaskMode;
+/**
+ * 面向 MCP 客户端的引擎短码:
+ *   SA = S2（极睿Sa专业版，Sora 2 模型，自动 S2→S4 兜底）
+ *   SD = S5（极睿Sd专业版，Seedance 2.0）
+ *   HA = S6（极睿Ha专业版，HappyHorse 1.1）
+ */
+export type McpModel = "SA" | "SD" | "HA";
+export declare const MCP_VIDEO_MODELS: Record<McpModel, {
+    route: McpRoute;
+    engineName: string;
+    providerModel: string;
+}>;
+export declare function isMcpModel(value: unknown): value is McpModel;
+export declare function getMcpModelForRoute(route: McpRoute): McpModel;
+/**
+ * 把客户端传入的 model / route 值解析成内部 route。
+ * - 如果 model 有效，直接用对应的内部 route。
+ * - 否则如果 route 是有效 McpRoute，返回该 route。
+ * - 否则返回 "SA"（与现有默认行为保持一致）。
+ *
+ * 第二返回值 true 表示 route 走的是 deprecated alias（仅使用 route 而非 model）。
+ */
+export declare function resolveMcpEngine(args: {
+    model?: unknown;
+    route?: unknown;
+}): {
+    route: McpRoute;
+    model: McpModel;
+    engineName: string;
+    providerModel: string;
+    usedRouteAlias: boolean;
+};
 export declare function getMcpVideoStatusHint(dryRun?: boolean): string;

package/dist/videoRules.js

@@ -1,4 +1,4 @@
-export const MCP_SERVER_VERSION = "1.0.9";
+export const MCP_SERVER_VERSION = "1.0.10";
 export const MCP_VIDEO_STATUS_HINT = "任务已创建后，使用 get_video_status 并传入 taskId 查询生成进度和视频链接。";
 export const MCP_VIDEO_DRY_RUN_HINT = "dryRun 仅完成参数、权限、积分和素材规则预检，不会创建任务或扣费。";
 export const MCP_VIDEO_ENGINES = {
@@ -16,7 +16,7 @@ export const MCP_VIDEO_ENGINES = {
     },
     S6: {
         engineName: "极睿Ha专业版",
-        model: "happyhorse-1.0",
+        model: "happyhorse-1.1",
         defaultTaskMode: "standard",
         taskModes: ["standard", "reference", "edit"],
     },
@@ -39,6 +39,64 @@ export function getMcpDefaultTaskMode(route, isFirstLastMode) {
 export function isValidMcpTaskMode(route, taskMode) {
     return MCP_VIDEO_ENGINES[route].taskModes.includes(taskMode);
 }
+export const MCP_VIDEO_MODELS = {
+    SA: { route: "S2", engineName: "极睿Sa专业版", providerModel: "sora-2" },
+    SD: { route: "S5", engineName: "极睿Sd专业版", providerModel: "doubao-seedance-2-0-260128" },
+    HA: { route: "S6", engineName: "极睿Ha专业版", providerModel: "happyhorse-1.1" },
+};
+export function isMcpModel(value) {
+    return value === "SA" || value === "SD" || value === "HA";
+}
+export function getMcpModelForRoute(route) {
+    if (route === "S2")
+        return "SA";
+    if (route === "S5")
+        return "SD";
+    if (route === "S6")
+        return "HA";
+    return "SA"; // 默认回退
+}
+/**
+ * 把客户端传入的 model / route 值解析成内部 route。
+ * - 如果 model 有效，直接用对应的内部 route。
+ * - 否则如果 route 是有效 McpRoute，返回该 route。
+ * - 否则返回 "SA"（与现有默认行为保持一致）。
+ *
+ * 第二返回值 true 表示 route 走的是 deprecated alias（仅使用 route 而非 model）。
+ */
+export function resolveMcpEngine(args) {
+    if (isMcpModel(args.model)) {
+        const entry = MCP_VIDEO_MODELS[args.model];
+        return {
+            route: entry.route,
+            model: args.model,
+            engineName: entry.engineName,
+            providerModel: entry.providerModel,
+            usedRouteAlias: false,
+        };
+    }
+    if (isMcpRoute(typeof args.route === "string" ? args.route : "")) {
+        const r = args.route;
+        const m = getMcpModelForRoute(r);
+        const entry = MCP_VIDEO_MODELS[m];
+        return {
+            route: r,
+            model: m,
+            engineName: entry.engineName,
+            providerModel: entry.providerModel,
+            usedRouteAlias: true,
+        };
+    }
+    // 默认 SA
+    const entry = MCP_VIDEO_MODELS.SA;
+    return {
+        route: entry.route,
+        model: "SA",
+        engineName: entry.engineName,
+        providerModel: entry.providerModel,
+        usedRouteAlias: false,
+    };
+}
 export function getMcpVideoStatusHint(dryRun) {
     return dryRun ? MCP_VIDEO_DRY_RUN_HINT : MCP_VIDEO_STATUS_HINT;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infimind/video-mcp-cli",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "MCP Server for Sora AI Video Generator - Access video generation features through Claude Desktop",
   "type": "module",
   "main": "dist/index.js",