@infimind/video-mcp-cli 1.0.10 → 1.0.12

package/dist/server.js

@@ -8,7 +8,8 @@ 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, getMcpModelForRoute, isMcpModel, MCP_VIDEO_MODELS, } from "./videoRules.js";
+import { MCP_CREATIVE_TOOLS } from "./creativeTools.js";
 class McpToolError extends Error {
     code;
     route;
@@ -21,10 +22,7 @@ class McpToolError extends Error {
         this.engineName = route ? getMcpEngineName(route) : undefined;
     }
 }
-/**
- * Create and configure the MCP Server
- */
-export function createServer(token, apiBaseUrl) {
+export function createServer(token, apiBaseUrl, options = {}) {
     const server = new Server({
         name: "sora-video-generator-mcp",
         version: MCP_SERVER_VERSION,
@@ -37,7 +35,7 @@ export function createServer(token, apiBaseUrl) {
      * List available tools
      */
     server.setRequestHandler(ListToolsRequestSchema, async () => {
-        const tools = [
+        const allTools = [
             {
                 name: "get_user_info",
                 title: "获取用户信息",
@@ -65,97 +63,144 @@ export function createServer(token, apiBaseUrl) {
             },
             {
                 name: "create_video_task",
-                title: "创建视频生成任务",
-                description: "创建视频生成任务。支持本地文件路径或公网 URL 作为参考图片。" +
-                    "支持极睿Sd专业版和极睿Ha专业版的多模态素材输入。",
+                title: "生成 AI 视频",
+                description: "根据提示词和可选的图片、视频或音频素材创建 AI 视频生成任务，可选择 SA、SD 或 HA 专业版；素材可使用本地文件路径或公网 URL。" +
+                    "本工具返回 taskId，不直接返回最终视频；创建后请调用 get_video_status 并原样传入 taskId，轮询生成进度和结果。",
                 inputSchema: {
                     type: "object",
+                    title: "AI 视频生成参数",
+                    description: "创建 AI 视频生成任务所需的提示词、参考素材和生成配置。",
                     properties: {
                         prompt: {
                             type: "string",
-                            description: "视频生成提示词，描述你想要创建的内容",
+                            title: "视频生成提示词",
+                            description: "必填。描述希望生成的视频内容、主体、动作、场景、镜头和风格。",
                         },
                         sourceImage: {
                             type: "string",
-                            description: "可选的单张参考图片。S2 使用此字段；S6 标准模式可用作单图图生视频。可以是本地文件路径或公网 URL",
+                            title: "单张参考图片",
+                            description: "可选。本地图片路径或公网 URL；SA 专业版图生视频或 HA 专业版标准模式单图生成时使用。",
                         },
                         sourceImages: {
                             type: "array",
-                            description: "S5/S6 多张参考图片。本地文件路径或公网 URL 数组。S5 首尾帧模式下第1张为首帧、第2张为尾帧；S6 reference/edit 模式作为参考图",
-                            items: { type: "string" },
+                            title: "参考图片列表",
+                            description: "可选。本地图片路径或公网 URL 列表；SD 专业版首尾帧模式按首帧、尾帧顺序传入，HA 专业版图片参考或视频编辑模式按引用顺序传入。",
+                            items: {
+                                type: "string",
+                                title: "参考图片",
+                                description: "一张参考图片的本地路径或公网 URL。",
+                            },
                         },
                         sourceVideos: {
                             type: "array",
-                            description: "S5 全能参考或 S6 视频编辑模式的视频素材。本地文件路径或公网 URL 数组",
-                            items: { type: "string" },
+                            title: "参考视频列表",
+                            description: "可选。本地视频路径或公网 URL 列表；用于 SD 专业版全能参考模式或 HA 专业版视频编辑模式。",
+                            items: {
+                                type: "string",
+                                title: "参考视频",
+                                description: "一段参考视频的本地路径或公网 URL。",
+                            },
                         },
                         sourceAudios: {
                             type: "array",
-                            description: "S5 全能参考模式的音频素材。本地文件路径或公网 URL 数组",
-                            items: { type: "string" },
+                            title: "参考音频列表",
+                            description: "可选。本地音频路径或公网 URL 列表；用于 SD 专业版全能参考模式。",
+                            items: {
+                                type: "string",
+                                title: "参考音频",
+                                description: "一段参考音频的本地路径或公网 URL。",
+                            },
                         },
                         sourceVideoDurationSeconds: {
                             type: "array",
-                            description: "可选。dryRun 使用的视频素材时长秒数数组，顺序与 sourceVideos 一致；用于获得预估积分",
-                            items: { type: "number" },
+                            title: "参考视频时长列表",
+                            description: "可选。仅在 dryRun 预检时用于估算积分，单位为秒，顺序须与 sourceVideos 一致。",
+                            items: {
+                                type: "number",
+                                title: "参考视频时长",
+                                description: "对应参考视频的时长，单位为秒。",
+                            },
                         },
                         sourceAudioDurationSeconds: {
                             type: "array",
-                            description: "可选。dryRun 使用的音频素材时长秒数数组，顺序与 sourceAudios 一致；用于获得预估积分",
-                            items: { type: "number" },
+                            title: "参考音频时长列表",
+                            description: "可选。仅在 dryRun 预检时用于估算积分，单位为秒，顺序须与 sourceAudios 一致。",
+                            items: {
+                                type: "number",
+                                title: "参考音频时长",
+                                description: "对应参考音频的时长，单位为秒。",
+                            },
                         },
                         size: {
                             type: "string",
-                            description: "视频方向/比例。S2 支持横竖屏；S5/S6 还支持正方形、4:3、3:4（默认：1280x720）",
+                            title: "输出尺寸",
+                            description: "可选。视频的输出尺寸，默认 1280x720；可选择横屏、竖屏、正方形、4:3 或 3:4 尺寸。",
                             enum: ["1280x720", "720x1280", "1024x1024", "1024x768", "768x1024"],
                         },
                         seconds: {
                             type: "number",
-                            description: "视频时长（秒）。S2=10或15秒；S5极睿Sd专业版=5、10或15秒；S6极睿Ha专业版 standard/reference=5、10或15秒，edit 模式由输入视频决定",
-                            enum: [5, 10, 15],
+                            title: "视频时长",
+                            description: "可选。输出视频时长，单位为秒；SA 专业版支持 10 或 15 秒，SD 专业版和 HA 专业版标准/图片参考模式支持 5、10 或 15 秒，SD2.5 专业版支持 5、10、15、20、25 或 30 秒，H3 专业版支持 5、10 或 15 秒，HA 专业版视频编辑模式由输入视频决定。",
+                            enum: [5, 10, 15, 20, 25, 30],
                         },
                         language: {
                             type: "string",
-                            description: "视频的目标语言（默认：zh-CN）",
+                            title: "提示词优化语言",
+                            description: "可选。用于理解和优化视频提示词的语言区域代码，默认 zh-CN。",
                             enum: ["zh-CN", "en-US", "ja-JP", "ko-KR", "es-ES", "fr-FR", "th-TH", "id-ID", "de-DE", "pt-PT", "bn-BD", "ru-RU", "ar-SA", "zh-HK", "hi-IN"],
                         },
                         count: {
                             type: "number",
-                            description: "生成的视频数量（1-12，默认：1）",
+                            title: "生成数量",
+                            description: "可选。需要生成的视频数量，范围 1–12，默认 1。",
                             minimum: 1,
                             maximum: 12,
                         },
+                        model: {
+                            type: "string",
+                            title: "生成模型",
+                            description: "可选。SA=极睿 Sa 专业版（默认），SD=极睿 Sd 专业版，SD25=极睿 SD2.5 专业版，HA=极睿 Ha 专业版，H3=极睿 H3 专业版；SD、SD25、HA、H3 仅限 VIP 用户使用。",
+                            enum: ["SA", "SD", "SD25", "HA", "H3"],
+                        },
                         route: {
                             type: "string",
-                            description: "使用的生成引擎：S2=极睿Sa专业版（默认）、S5=极睿Sd专业版、S6=极睿Ha专业版。注意：S5、S6 仅限 VIP 用户使用",
-                            enum: ["S2", "S5", "S6"],
+                            title: "兼容模型参数",
+                            description: "已废弃的兼容参数，仅供旧客户端使用；新调用请使用 model 选择 SA、SD、SD25、HA 或 H3 专业版。",
+                            enum: ["S2", "S5", "S6", "S7", "S8"],
+                            deprecated: true,
                         },
                         taskMode: {
                             type: "string",
-                            description: "引擎模式。S5: allinone=全能参考、firstlast=首尾帧；S6: standard=标准模式、reference=图片参考、edit=视频编辑",
+                            title: "生成模式",
+                            description: "可选。allinone=全能参考，firstlast=首尾帧，standard=标准模式，reference=图片参考，edit=视频编辑；可用模式取决于所选模型。",
                             enum: ["allinone", "firstlast", "standard", "reference", "edit"],
                         },
                         resolution: {
                             type: "string",
-                            description: "S5/S6 输出清晰度（默认：720p）",
+                            title: "输出清晰度",
+                            description: "可选。SD 或 HA 专业版可选 720p 或 1080p；SD2.5 专业版仅支持 480p 或 720p；默认 720p。",
                             enum: ["720p", "1080p"],
                         },
                         ratio: {
                             type: "string",
-                            description: "S6 图片参考或标准文生视频模式的宽高比，例如 9:16、16:9、1:1、4:3、3:4",
+                            title: "画面比例",
+                            description: "可选。HA 专业版图片参考或标准文生视频模式的画面比例，可选 16:9、9:16、1:1、4:3 或 3:4。",
                             enum: ["16:9", "9:16", "1:1", "4:3", "3:4"],
                         },
                         generateAudio: {
                             type: "boolean",
-                            description: "S5 极睿Sd专业版是否生成音频（默认：true）",
+                            title: "生成音频",
+                            description: "可选。SD / SD2.5 专业版是否同时生成音频，默认 true。",
                         },
                         webSearchEnabled: {
                             type: "boolean",
-                            description: "S5 极睿Sd专业版是否启用 Agent 增强（默认：false）",
+                            title: "启用内容增强",
+                            description: "可选。SD 专业版是否启用联网内容增强，默认 false；SD2.5 专业版不支持。",
                         },
                         dryRun: {
                             type: "boolean",
-                            description: "仅执行参数、素材、权限和积分预检，不创建任务、不扣费。适合在正式创建前确认 S5/S6 参数是否可用",
+                            title: "仅预检",
+                            description: "可选。设为 true 时仅校验参数、素材、权限并估算积分，不创建任务且不扣费；默认 false。",
                         },
                     },
                     required: ["prompt"],
@@ -163,86 +208,95 @@ export function createServer(token, apiBaseUrl) {
                 },
                 outputSchema: {
                     type: "object",
+                    title: "AI 视频任务创建结果",
+                    description: "返回任务标识、所用配置、积分信息和后续查询提示；预检或失败时部分字段可能不返回。",
                     properties: {
-                        success: { type: "boolean" },
-                        taskId: { type: "number" },
-                        route: { type: "string" },
-                        engineName: { type: "string" },
-                        taskMode: { type: "string" },
-                        videoCount: { type: "number" },
-                        dryRun: { type: "boolean" },
-                        estimatedCredits: { type: "number" },
-                        estimateSource: { type: "string" },
-                        remainingCredits: { type: "number" },
-                        statusHint: { type: "string" },
+                        success: { type: "boolean", title: "是否成功", description: "表示任务创建或预检请求是否成功。" },
+                        taskId: { type: "number", title: "任务 ID", description: "创建成功后返回的视频任务 ID；dryRun 或失败时可能不返回，请用于调用 get_video_status。" },
+                        model: { type: "string", title: "生成模型", description: "实际使用的模型短码：SA、SD、SD25、HA 或 H3。" },
+                        route: { type: "string", title: "兼容模型标识", description: "为旧客户端返回的兼容模型标识。" },
+                        engineName: { type: "string", title: "模型名称", description: "实际使用的极睿专业版模型名称。" },
+                        usedRouteAlias: { type: "boolean", title: "是否使用兼容参数", description: "表示本次调用是否通过已废弃的 route 参数选择模型。" },
+                        taskMode: { type: "string", title: "生成模式", description: "本次任务实际使用的生成模式。" },
+                        videoCount: { type: "number", title: "视频数量", description: "本次任务计划生成的视频数量。" },
+                        dryRun: { type: "boolean", title: "是否仅预检", description: "表示本次请求是否只进行了预检而未创建任务。" },
+                        estimatedCredits: { type: "number", title: "预估积分", description: "完成本次任务预计需要的积分；无法估算时可能不返回。" },
+                        estimateSource: { type: "string", title: "估算依据", description: "预估积分所依据的素材检测结果或时长提示。" },
+                        remainingCredits: { type: "number", title: "剩余积分", description: "请求处理后的账户剩余积分。" },
+                        statusHint: { type: "string", title: "后续操作提示", description: "提示是否应使用 taskId 调用 get_video_status 查询任务进度。" },
                         validationWarnings: {
                             type: "array",
-                            items: { type: "string" },
+                            title: "预检警告",
+                            description: "参数或素材预检产生的非阻断性提示列表。",
+                            items: { type: "string", title: "预检警告项", description: "一条需要关注但不阻断请求的预检提示。" },
                         },
-                        code: { type: "string" },
-                        message: { type: "string" },
+                        code: { type: "string", title: "错误代码", description: "请求失败时返回的机器可读错误代码，成功时可能不返回。" },
+                        message: { type: "string", title: "结果消息", description: "请求结果或失败原因的可读说明。" },
                     },
                     required: ["success"],
                 },
             },
             {
                 name: "get_video_status",
-                title: "查询视频生成状态",
-                description: "获取视频生成任务的状态，包括进度和视频 URL",
+                title: "查询 AI 视频生成结果",
+                description: "根据 create_video_task 返回的 taskId 查询 AI 视频生成进度和结果。任务未完成时请间隔一段时间后使用同一 taskId 再次调用；完成后返回视频链接，失败时返回原因。",
                 inputSchema: {
                     type: "object",
+                    title: "AI 视频任务查询参数",
+                    description: "指定需要查询的视频生成任务。",
                     properties: {
                         taskId: {
                             type: "number",
-                            description: "视频生成任务 ID",
+                            title: "任务 ID",
+                            description: "必填。由 create_video_task 返回的视频任务 ID，请原样传入并用于后续轮询。",
                         },
                     },
                     required: ["taskId"],
                 },
                 outputSchema: {
                     type: "object",
+                    title: "AI 视频生成状态与结果",
+                    description: "返回任务进度、生成结果和错误信息；任务未完成时结果链接和完成时间可能为空。",
                     properties: {
-                        success: { type: "boolean" },
-                        taskId: { type: "number" },
-                        status: { type: "string" },
-                        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" },
-                        engineName: { type: "string" },
+                        success: { type: "boolean", title: "是否成功", description: "表示查询请求是否成功。" },
+                        taskId: { type: "number", title: "任务 ID", description: "当前查询的视频任务 ID。" },
+                        status: { type: "string", title: "任务状态", description: "视频任务当前的处理状态；未完成时应根据 statusHint 稍后重试。" },
+                        progress: { type: "number", title: "总体进度", description: "任务总体处理进度，通常为 0–100 的数值。" },
+                        totalVideos: { type: "number", title: "视频总数", description: "任务计划生成的视频总数。" },
+                        completedVideos: { type: "number", title: "已完成数量", description: "当前已经完成生成的视频数量。" },
+                        estimatedCredits: { type: "number", title: "预估积分", description: "任务预计消耗的积分；无法估算时可能不返回。" },
+                        taskMode: { type: ["string", "null"], title: "生成模式", description: "任务使用的生成模式；旧任务或尚未确定时可能为空。" },
+                        statusHint: { type: "string", title: "状态提示", description: "面向用户的当前状态和下一步轮询提示。" },
+                        createdAt: { type: ["string", "null"], title: "创建时间", description: "任务创建时间；不可用时为空。" },
+                        updatedAt: { type: ["string", "null"], title: "更新时间", description: "任务最近更新时间；不可用时为空。" },
+                        completedAt: { type: ["string", "null"], title: "完成时间", description: "任务完成时间；未完成时为空。" },
+                        errorMessage: { type: "string", title: "错误信息", description: "任务失败时的可读原因，未失败时可能不返回。" },
+                        errorCode: { type: "string", title: "错误代码", description: "任务失败时的机器可读错误代码，未失败时可能不返回。" },
+                        errorCategory: { type: "string", title: "错误分类", description: "任务失败时的错误类别，未失败时可能不返回。" },
+                        retryable: { type: "boolean", title: "是否可重试", description: "表示失败后是否建议重新发起任务，未失败时可能不返回。" },
+                        code: { type: "string", title: "查询错误代码", description: "查询请求失败时的机器可读错误代码，成功时可能不返回。" },
+                        message: { type: "string", title: "查询消息", description: "查询结果或失败原因的可读说明。" },
+                        route: { type: "string", title: "兼容模型标识", description: "任务对应的兼容模型标识。" },
+                        engineName: { type: "string", title: "模型名称", description: "任务实际使用的极睿专业版模型名称。" },
                         videos: {
                             type: "array",
+                            title: "视频结果列表",
+                            description: "每个待生成视频的状态和结果；单项未完成时链接可能为空。",
                             items: {
                                 type: "object",
+                                title: "视频结果",
+                                description: "一个视频生成结果及其状态、链接、时间和错误信息。",
                                 properties: {
-                                    id: { type: "number" },
-                                    status: { type: "string" },
-                                    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"] },
+                                    id: { type: "number", title: "视频结果 ID", description: "该视频结果在任务中的唯一标识。" },
+                                    status: { type: "string", title: "视频状态", description: "该视频当前的生成状态。" },
+                                    videoUrl: { type: ["string", "null"], title: "视频 URL", description: "生成完成后的视频访问 URL；未完成或失败时为空。" },
+                                    thumbnailUrl: { type: ["string", "null"], title: "缩略图 URL", description: "视频缩略图访问 URL；尚未生成时为空。" },
+                                    errorMessage: { type: ["string", "null"], title: "错误信息", description: "该视频生成失败时的可读原因；未失败时为空。" },
+                                    errorCode: { type: ["string", "null"], title: "错误代码", description: "该视频生成失败时的机器可读错误代码；未失败时为空。" },
+                                    errorCategory: { type: ["string", "null"], title: "错误分类", description: "该视频生成失败时的错误类别；未失败时为空。" },
+                                    retryable: { type: ["boolean", "null"], title: "是否可重试", description: "表示该视频失败后是否建议重新创建任务；未失败时为空。" },
+                                    createdAt: { type: ["string", "null"], title: "创建时间", description: "该视频结果的创建时间；不可用时为空。" },
+                                    completedAt: { type: ["string", "null"], title: "完成时间", description: "该视频的完成时间；未完成时为空。" },
                                 },
                                 required: ["id", "status", "videoUrl", "thumbnailUrl", "errorMessage"],
                             },
@@ -253,70 +307,82 @@ export function createServer(token, apiBaseUrl) {
             },
             {
                 name: "create_video_analysis_task",
-                title: "创建视频拆解任务",
-                description: "创建视频拆解任务，将视频拆解为脚本、风格、卖点话术、爆款公式，并生成用于视频创作的提示词。" +
-                    "支持本地文件路径或公网 URL。",
+                title: "分析参考视频内容",
+                description: "分析本地视频或公网 URL，提取脚本、风格、卖点、创作公式并生成视频创作提示词；本工具不会生成最终视频。" +
+                    "本工具返回 analysisId，创建后请调用 get_video_analysis_status 并原样传入 analysisId，轮询分析进度和结果。",
                 inputSchema: {
                     type: "object",
+                    title: "参考视频分析参数",
+                    description: "指定需要分析的参考视频。",
                     properties: {
                         videoFile: {
                             type: "string",
-                            description: "要分析的视频文件，可以是本地文件路径或公网 URL",
+                            title: "参考视频",
+                            description: "必填。需要分析的视频本地文件路径或公网 URL。",
                         },
                     },
                     required: ["videoFile"],
                 },
                 outputSchema: {
                     type: "object",
+                    title: "视频分析任务创建结果",
+                    description: "返回分析任务标识、积分信息和后续查询提示；失败时部分字段可能不返回。",
                     properties: {
-                        success: { type: "boolean" },
-                        analysisId: { type: "number" },
-                        creditsUsed: { type: "number" },
-                        remainingCredits: { type: "number" },
-                        statusHint: { type: "string" },
-                        code: { type: "string" },
-                        message: { type: "string" },
+                        success: { type: "boolean", title: "是否成功", description: "表示视频分析任务是否创建成功。" },
+                        analysisId: { type: "number", title: "分析任务 ID", description: "创建成功后返回的分析任务 ID，请用于调用 get_video_analysis_status。" },
+                        creditsUsed: { type: "number", title: "消耗积分", description: "创建本次视频分析任务实际扣除的积分。" },
+                        remainingCredits: { type: "number", title: "剩余积分", description: "任务创建后的账户剩余积分。" },
+                        statusHint: { type: "string", title: "后续操作提示", description: "提示使用 analysisId 调用 get_video_analysis_status 查询分析进度。" },
+                        code: { type: "string", title: "错误代码", description: "创建失败时返回的机器可读错误代码，成功时可能不返回。" },
+                        message: { type: "string", title: "结果消息", description: "创建结果或失败原因的可读说明。" },
                     },
                     required: ["success"],
                 },
             },
             {
                 name: "get_video_analysis_status",
-                title: "查询视频拆解状态",
-                description: "获取视频拆解任务的状态和结果",
+                title: "查询视频分析结果",
+                description: "根据 create_video_analysis_task 返回的 analysisId 查询分析进度和结构化结果。任务未完成时请间隔一段时间后使用同一 analysisId 再次调用。",
                 inputSchema: {
                     type: "object",
+                    title: "视频分析任务查询参数",
+                    description: "指定需要查询的视频分析任务。",
                     properties: {
                         analysisId: {
                             type: "number",
-                            description: "视频拆解任务 ID",
+                            title: "分析任务 ID",
+                            description: "必填。由 create_video_analysis_task 返回的分析任务 ID，请原样传入并用于后续轮询。",
                         },
                     },
                     required: ["analysisId"],
                 },
                 outputSchema: {
                     type: "object",
+                    title: "视频分析状态与结果",
+                    description: "返回分析进度和结构化内容；任务未完成或失败时分析内容可能为空。",
                     properties: {
-                        success: { type: "boolean" },
-                        analysisId: { type: "number" },
-                        status: { type: "string" },
-                        conversionProgress: { type: ["number", "null"] },
-                        script: { type: ["string", "null"] },
-                        style: { type: ["string", "null"] },
-                        sellingPoints: { type: ["string", "null"] },
-                        viralFormula: { type: ["string", "null"] },
-                        generatedPrompt: { type: ["string", "null"] },
-                        errorMessage: { type: ["string", "null"] },
-                        originalVideoUrl: { type: ["string", "null"] },
-                        videoFileName: { type: ["string", "null"] },
-                        code: { type: "string" },
-                        message: { type: "string" },
+                        success: { type: "boolean", title: "是否成功", description: "表示查询请求是否成功。" },
+                        analysisId: { type: "number", title: "分析任务 ID", description: "当前查询的视频分析任务 ID。" },
+                        status: { type: "string", title: "分析状态", description: "视频分析任务当前的处理状态；未完成时应稍后继续查询。" },
+                        conversionProgress: { type: ["number", "null"], title: "处理进度", description: "视频转换和分析进度，通常为 0–100；尚未开始时可能为空。" },
+                        script: { type: ["string", "null"], title: "视频脚本", description: "从参考视频中提取的脚本内容；分析未完成时为空。" },
+                        style: { type: ["string", "null"], title: "视频风格", description: "识别出的视觉、叙事和表达风格；分析未完成时为空。" },
+                        sellingPoints: { type: ["string", "null"], title: "卖点分析", description: "从视频中识别出的商品或内容卖点；分析未完成时为空。" },
+                        viralFormula: { type: ["string", "null"], title: "创作公式", description: "总结的视频结构和内容创作公式；分析未完成时为空。" },
+                        generatedPrompt: { type: ["string", "null"], title: "生成提示词", description: "基于分析结果生成的后续视频创作提示词；分析未完成时为空。" },
+                        errorMessage: { type: ["string", "null"], title: "错误信息", description: "分析失败时的可读原因；未失败时为空。" },
+                        originalVideoUrl: { type: ["string", "null"], title: "原视频 URL", description: "本次分析所使用的视频访问 URL；不可用时为空。" },
+                        videoFileName: { type: ["string", "null"], title: "视频文件名", description: "参考视频的文件名；不可用时为空。" },
+                        code: { type: "string", title: "查询错误代码", description: "查询请求失败时返回的机器可读错误代码，成功时可能不返回。" },
+                        message: { type: "string", title: "查询消息", description: "查询结果或失败原因的可读说明。" },
                     },
                     required: ["success"],
                 },
             },
+            ...MCP_CREATIVE_TOOLS,
         ];
-        return { tools };
+        const filtered = options.filterTools ? options.filterTools(allTools) : allTools;
+        return { tools: filtered };
     });
     /**
      * Handle tool calls
@@ -335,6 +401,14 @@ export function createServer(token, apiBaseUrl) {
                     return await handleCreateVideoAnalysisTask(apiBaseUrl, token, args);
                 case "get_video_analysis_status":
                     return await handleGetVideoAnalysisStatus(apiBaseUrl, token, args);
+                case "create_motion_video_remake_task":
+                    return await handleCreateMotionVideoRemakeTask(apiBaseUrl, token, args);
+                case "get_motion_video_remake_status":
+                    return await handleGetMotionVideoRemakeStatus(apiBaseUrl, token, args);
+                case "create_ecommerce_storyboard_task":
+                    return await handleCreateEcommerceStoryboardTask(apiBaseUrl, token, args);
+                case "get_ecommerce_storyboard_status":
+                    return await handleGetEcommerceStoryboardStatus(apiBaseUrl, token, args);
                 default:
                     throw new Error(`Unknown tool: ${name}`);
             }
@@ -400,7 +474,7 @@ async function handleGetUserInfo(apiBaseUrl, token) {
  * 处理文件输入：支持本地文件路径或公网 URL
  * 对于本地文件，读取并转换为 base64
  */
-async function processFileInput(fileInput, expectedType) {
+async function processFileInput(fileInput, expectedType, maxBytes) {
     // 检查是否是公网 URL
     if (fileInput.startsWith("http://") || fileInput.startsWith("https://")) {
         return {
@@ -416,8 +490,6 @@ async function processFileInput(fileInput, expectedType) {
     if (!existsSync(filePath)) {
         throw new McpToolError(`文件不存在: ${filePath}`, "FILE_NOT_FOUND");
     }
-    // 读取文件
-    const buffer = readFileSync(filePath);
     // 获取文件扩展名并确定 MIME type
     const ext = extname(filePath).toLowerCase();
     let mimeType = "application/octet-stream";
@@ -440,12 +512,12 @@ async function processFileInput(fileInput, 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");
+    const effectiveMaxBytes = maxBytes ?? (expectedType === "video" ? 50 * 1024 * 1024 : expectedType === "audio" ? 15 * 1024 * 1024 : undefined);
+    if (effectiveMaxBytes !== undefined && size > effectiveMaxBytes) {
+        throw new McpToolError(`文件 ${basename(filePath)} 超过 ${Math.floor(effectiveMaxBytes / 1024 / 1024)}MB 限制。`, "MEDIA_FILE_TOO_LARGE");
     }
+    // 通过大小预检后再读取，避免将超限文件装入内存。
+    const buffer = readFileSync(filePath);
     // 转换为 base64
     const base64 = `data:${mimeType};base64,${buffer.toString("base64")}`;
     return {
@@ -470,28 +542,43 @@ 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、SD25、HA 或 H3；route 只接受 S2、S5、S6、S7、S8（已废弃），请改用 model。", "INVALID_ENGINE");
     }
-    return route;
+    const m = getMcpModelForRoute(route);
+    return {
+        route,
+        model: m,
+        usedRouteAlias: true,
+    };
 }
 function normalizeTaskMode(route, value) {
     const mode = typeof value === "string" ? value : getMcpDefaultTaskMode(route);
     if (route === "S2") {
         if (value !== undefined) {
-            throw new McpToolError("taskMode 仅适用于极睿Sd专业版或极睿Ha专业版；S2 极睿Sa专业版无需传 taskMode。", "UNSUPPORTED_FIELD", route);
+            throw new McpToolError("taskMode 仅适用于极睿SD专业版或极睿HA专业版；S2 极睿SA专业版无需传 taskMode。", "UNSUPPORTED_FIELD", route);
         }
         return getMcpDefaultTaskMode(route);
     }
     if (!isValidMcpTaskMode(route, mode)) {
-        const allowedModes = route === "S5" ? "allinone 或 firstlast" : "standard、reference 或 edit";
+        const allowedModes = route === "S5" || route === "S8" ? "allinone 或 firstlast" : route === "S7" ? "allinone、firstlast 或 reference" : "standard、reference 或 edit";
         throw new McpToolError(`${getMcpEngineName(route)} 的 taskMode 只能是 ${allowedModes}。`, "INVALID_TASK_MODE", route);
     }
     return mode;
 }
-function validateCreateVideoArgs(args) {
+export function validateCreateVideoArgs(args) {
     if (!args || typeof args !== "object") {
         throw new McpToolError("请提供视频生成参数。");
     }
@@ -501,15 +588,28 @@ 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 (route === "S8" && resolution !== "480p" && resolution !== "720p") {
+        throw new McpToolError(`${getMcpEngineName(route)} 仅支持 480p 或 720p。`, "INVALID_RESOLUTION", 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);
+        throw new McpToolError("极睿SA专业版不支持 5 秒视频，请使用 10 或 15 秒。", "INVALID_SECONDS", route);
+    }
+    // S5/S6/S7/S8 的 seconds 白名单
+    if (route === "S5" || route === "S6" || route === "S7" || route === "S8") {
+        const allowedSeconds = route === "S8" ? [5, 10, 15, 20, 25, 30] : [5, 10, 15];
+        if (args.seconds !== undefined && !allowedSeconds.includes(args.seconds)) {
+            throw new McpToolError(route === "S8"
+                ? `${getMcpEngineName(route)} 视频时长仅支持 5、10、15、20、25、30 秒。`
+                : `${getMcpEngineName(route)} 视频时长仅支持 5、10、15 秒。`, "INVALID_SECONDS", route);
+        }
     }
     if (route === "S2") {
         const unsupported = [
@@ -522,36 +622,47 @@ function validateCreateVideoArgs(args) {
             args.webSearchEnabled !== undefined ? "webSearchEnabled" : undefined,
         ].filter(Boolean);
         if (unsupported.length > 0) {
-            throw new McpToolError(`这些字段不适用于极睿Sa专业版：${unsupported.join("、")}。S2 单图请使用 sourceImage。`, "UNSUPPORTED_FIELD", route);
+            throw new McpToolError(`这些字段不适用于极睿SA专业版：${unsupported.join("、")}。S2 单图请使用 sourceImage。`, "UNSUPPORTED_FIELD", route);
         }
     }
-    if (route === "S5") {
+    if (route === "S5" || route === "S8") {
+        // S8 = SD2.5 独立通道：素材上限放宽（30 图 / 10 视频 / 10 音频），支持纯音频参考，
+        // 不支持联网搜索；文案与上限按通道区分。
+        const isSd25 = route === "S8";
+        const sdEngine = getMcpEngineName(route);
         if (args.sourceImage !== undefined) {
-            throw new McpToolError("sourceImage 不适用于极睿Sd专业版；请使用 sourceImages 传参考图或首尾帧。", "UNSUPPORTED_FIELD", route);
+            throw new McpToolError(`sourceImage 不适用于${sdEngine}；请使用 sourceImages 传参考图或首尾帧。`, "UNSUPPORTED_FIELD", route);
         }
         if (args.ratio !== undefined) {
-            throw new McpToolError("ratio 仅适用于极睿Ha专业版；极睿Sd专业版请使用 size 控制画面比例。", "UNSUPPORTED_FIELD", route);
+            throw new McpToolError(`ratio 仅适用于极睿HA专业版；${sdEngine}请使用 size 控制画面比例。`, "UNSUPPORTED_FIELD", route);
+        }
+        if (isSd25 && args.webSearchEnabled !== undefined) {
+            throw new McpToolError(`webSearchEnabled 不适用于${sdEngine}（SD2.5 不支持联网搜索）。`, "UNSUPPORTED_FIELD", route);
         }
         if (taskMode === "firstlast" && !hasItems(args.sourceImages)) {
-            throw new McpToolError("极睿Sd专业版首尾帧模式需要在 sourceImages 中提供至少 1 张首帧图片。", "MISSING_SOURCE_IMAGE", route);
+            throw new McpToolError(`${sdEngine}首尾帧模式需要在 sourceImages 中提供至少 1 张首帧图片。`, "MISSING_SOURCE_IMAGE", route);
         }
         if (taskMode === "firstlast" && (hasItems(args.sourceVideos) || hasItems(args.sourceAudios))) {
-            throw new McpToolError("sourceVideos/sourceAudios 仅适用于极睿Sd专业版全能参考模式；首尾帧模式只使用 sourceImages。", "UNSUPPORTED_FIELD", route);
+            throw new McpToolError(`sourceVideos/sourceAudios 仅适用于${sdEngine}全能参考模式；首尾帧模式只使用 sourceImages。`, "UNSUPPORTED_FIELD", route);
         }
         if (taskMode === "firstlast" && itemCount(args.sourceImages) > 2) {
-            throw new McpToolError("极睿Sd专业版首尾帧模式最多支持 2 张图片。", "MEDIA_COUNT_EXCEEDED", route);
+            throw new McpToolError(`${sdEngine}首尾帧模式最多支持 2 张图片。`, "MEDIA_COUNT_EXCEEDED", route);
         }
-        if (taskMode === "allinone" && itemCount(args.sourceImages) > 9) {
-            throw new McpToolError("极睿Sd专业版全能参考模式最多支持 9 张参考图片。", "MEDIA_COUNT_EXCEEDED", route);
+        const maxImages = isSd25 ? 30 : 9;
+        const maxVideos = isSd25 ? 10 : 3;
+        const maxAudios = isSd25 ? 10 : 3;
+        if (taskMode === "allinone" && itemCount(args.sourceImages) > maxImages) {
+            throw new McpToolError(`${sdEngine}全能参考模式最多支持 ${maxImages} 张参考图片。`, "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.sourceVideos) > maxVideos) {
+            throw new McpToolError(`${sdEngine}全能参考模式最多支持 ${maxVideos} 个参考视频。`, "MEDIA_COUNT_EXCEEDED", route);
         }
-        if (taskMode === "allinone" && itemCount(args.sourceAudios) > 3) {
-            throw new McpToolError("极睿Sd专业版全能参考模式最多支持 3 个参考音频。", "MEDIA_COUNT_EXCEEDED", route);
+        if (taskMode === "allinone" && itemCount(args.sourceAudios) > maxAudios) {
+            throw new McpToolError(`${sdEngine}全能参考模式最多支持 ${maxAudios} 个参考音频。`, "MEDIA_COUNT_EXCEEDED", route);
         }
-        if (taskMode === "allinone" && hasItems(args.sourceAudios) && !hasItems(args.sourceImages) && !hasItems(args.sourceVideos)) {
-            throw new McpToolError("极睿Sd专业版全能参考模式中，音频素材必须搭配至少一张参考图片或一个参考视频。", "MISSING_VISUAL_REFERENCE", route);
+        // 纯音频参考：S5 2.0 要求音频搭配图片/视频；S8（SD2.5）支持纯音频参考，豁免
+        if (!isSd25 && taskMode === "allinone" && hasItems(args.sourceAudios) && !hasItems(args.sourceImages) && !hasItems(args.sourceVideos)) {
+            throw new McpToolError(`${sdEngine}全能参考模式中，音频素材必须搭配至少一张参考图片或一个参考视频。`, "MISSING_VISUAL_REFERENCE", route);
         }
     }
     if (route === "S6") {
@@ -561,32 +672,66 @@ function validateCreateVideoArgs(args) {
             args.webSearchEnabled !== undefined ? "webSearchEnabled" : undefined,
         ].filter(Boolean);
         if (unsupported.length > 0) {
-            throw new McpToolError(`这些字段仅适用于极睿Sd专业版，不能用于极睿Ha专业版：${unsupported.join("、")}。`, "UNSUPPORTED_FIELD", route);
+            throw new McpToolError(`这些字段仅适用于极睿SD专业版，不能用于极睿HA专业版：${unsupported.join("、")}。`, "UNSUPPORTED_FIELD", route);
         }
         if (taskMode === "standard" && (hasItems(args.sourceImages) || hasItems(args.sourceVideos))) {
-            throw new McpToolError("极睿Ha专业版标准模式只支持 sourceImage 作为单图输入；多图请使用 reference 模式，视频请使用 edit 模式。", "UNSUPPORTED_FIELD", route);
+            throw new McpToolError("极睿HA专业版标准模式只支持 sourceImage 作为单图输入；多图请使用 reference 模式，视频请使用 edit 模式。", "UNSUPPORTED_FIELD", route);
         }
         if ((taskMode === "reference" || taskMode === "edit") && args.sourceImage !== undefined) {
-            throw new McpToolError("sourceImage 仅适用于极睿Ha专业版标准模式；reference/edit 模式请使用 sourceImages。", "UNSUPPORTED_FIELD", route);
+            throw new McpToolError("sourceImage 仅适用于极睿HA专业版标准模式；reference/edit 模式请使用 sourceImages。", "UNSUPPORTED_FIELD", route);
         }
         if (taskMode === "reference" && !hasItems(args.sourceImages)) {
-            throw new McpToolError("极睿Ha专业版图片参考模式需要在 sourceImages 中提供至少 1 张参考图片。", "MISSING_SOURCE_IMAGE", route);
+            throw new McpToolError("极睿HA专业版图片参考模式需要在 sourceImages 中提供至少 1 张参考图片。", "MISSING_SOURCE_IMAGE", route);
         }
         if (taskMode === "edit" && !hasItems(args.sourceVideos)) {
-            throw new McpToolError("极睿Ha专业版视频编辑模式需要在 sourceVideos 中提供至少 1 个参考视频。", "MISSING_SOURCE_VIDEO", route);
+            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);
+            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);
+            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);
+            throw new McpToolError("极睿HA专业版视频编辑模式最多支持 5 张参考图片。", "MEDIA_COUNT_EXCEEDED", route);
+        }
+    }
+    if (route === "S7") {
+        // S7 = H3（MiniMax V2）：固定 2K 输出；i2va/r2va 互斥；seconds 白名单 [5,10,15]（已在上方统一校验）。
+        if (args.resolution !== undefined) {
+            throw new McpToolError(`${getMcpEngineName(route)}固定 2K 输出，无需传 resolution。`, "UNSUPPORTED_FIELD", route);
+        }
+        if (args.sourceImage !== undefined) {
+            throw new McpToolError(`sourceImage 不适用于${getMcpEngineName(route)}；请使用 sourceImages 传参考图或首尾帧。`, "UNSUPPORTED_FIELD", route);
+        }
+        if (args.generateAudio !== undefined || args.webSearchEnabled !== undefined) {
+            throw new McpToolError(`generateAudio/webSearchEnabled 不适用于${getMcpEngineName(route)}。`, "UNSUPPORTED_FIELD", route);
+        }
+        if (taskMode === "firstlast") {
+            if (!hasItems(args.sourceImages)) {
+                throw new McpToolError(`${getMcpEngineName(route)}首尾帧模式需要在 sourceImages 中提供至少 1 张首帧图片。`, "MISSING_SOURCE_IMAGE", route);
+            }
+            if (hasItems(args.sourceVideos) || hasItems(args.sourceAudios)) {
+                throw new McpToolError(`sourceVideos/sourceAudios 仅适用于${getMcpEngineName(route)}全能参考模式；首尾帧模式只使用 sourceImages。`, "UNSUPPORTED_FIELD", route);
+            }
+            if (itemCount(args.sourceImages) > 2) {
+                throw new McpToolError(`${getMcpEngineName(route)}首尾帧模式最多支持 2 张图片（首帧 + 尾帧）。`, "MEDIA_COUNT_EXCEEDED", route);
+            }
+        }
+        else if (hasItems(args.sourceAudios) &&
+            !hasItems(args.sourceImages) &&
+            !hasItems(args.sourceVideos)) {
+            // r2va 不允许仅音频（与网页端 / 服务端校验一致）
+            throw new McpToolError(`${getMcpEngineName(route)}全能参考模式中，音频素材必须搭配至少一张参考图片或一个参考视频。`, "MISSING_VISUAL_REFERENCE", route);
+        }
+        if (itemCount(args.sourceImages) > 9) {
+            throw new McpToolError(`${getMcpEngineName(route)}最多支持 9 张参考图片。`, "MEDIA_COUNT_EXCEEDED", route);
         }
     }
     return {
         route,
+        model: norm.model,
+        usedRouteAlias: norm.usedRouteAlias,
         taskMode,
         resolution,
         dryRun,
@@ -598,7 +743,10 @@ function validateCreateVideoArgs(args) {
  */
 async function handleCreateVideoTask(apiBaseUrl, token, args) {
     const normalized = validateCreateVideoArgs(args);
-    const isProfessionalRoute = normalized.route === "S5" || normalized.route === "S6";
+    const isProfessionalRoute = normalized.route === "S5" ||
+        normalized.route === "S6" ||
+        normalized.route === "S7" ||
+        normalized.route === "S8";
     const requestBody = {
         token,
         prompt: args.prompt,
@@ -609,6 +757,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,
     };
@@ -663,8 +812,10 @@ 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,
@@ -693,10 +844,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) {
@@ -726,15 +874,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) {
@@ -757,9 +896,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,
@@ -889,6 +1025,118 @@ async function handleGetVideoAnalysisStatus(apiBaseUrl, token, args) {
         },
     };
 }
+function creativeToolResult(output, lines) {
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+        structuredContent: output,
+    };
+}
+async function handleCreateMotionVideoRemakeTask(apiBaseUrl, token, args) {
+    if (!args || typeof args.sourceImage !== "string" || typeof args.referenceVideo !== "string") {
+        throw new McpToolError("sourceImage 和 referenceVideo 不能为空。", "MISSING_PARAMETERS");
+    }
+    const sourceImage = await processFileInput(args.sourceImage, "image", 5 * 1024 * 1024);
+    const referenceVideo = await processFileInput(args.referenceVideo, "video", 100 * 1024 * 1024);
+    const response = await callRestApi(apiBaseUrl, "/mcp/motion-remake/create", {
+        token,
+        sourceImage: sourceImage.data,
+        referenceVideo: referenceVideo.data,
+        mode: args.mode,
+        quality: args.quality,
+        count: args.count,
+        referenceVideoDurationSeconds: args.referenceVideoDurationSeconds,
+        dryRun: args.dryRun === true,
+    }, "POST");
+    const lines = response.dryRun
+        ? [
+            "# 爆款视频复刻预检通过",
+            response.estimateSource === "duration_hint"
+                ? `- 时长提示: ${response.durationHintSeconds} 秒（正式创建将使用 OSS 真实检测值）`
+                : "- 时长提示: 未提供，正式创建后由 OSS 检测",
+            response.estimatedCredits === null || response.estimatedCredits === undefined
+                ? "- 预计积分: 暂不可用"
+                : `- 预计积分: ${response.estimatedCredits}`,
+            `- 当前余额: ${response.remainingCredits}`,
+            "- 未上传 OSS、未创建任务、未扣费",
+        ]
+        : [
+            "# 爆款视频复刻任务已创建",
+            `- 任务 ID: ${response.taskId}`,
+            `- 模式: ${response.mode}`,
+            `- 质量: ${response.quality}`,
+            `- 数量: ${response.count}`,
+            `- 已扣积分: ${response.creditsDeducted}`,
+            `- ${response.statusHint}`,
+        ];
+    return creativeToolResult(response, lines);
+}
+async function handleGetMotionVideoRemakeStatus(apiBaseUrl, token, args) {
+    if (!Number.isInteger(args?.taskId)) {
+        throw new McpToolError("taskId 必须是整数。", "BAD_REQUEST");
+    }
+    const response = await callRestApi(apiBaseUrl, `/mcp/motion-remake/status/${args.taskId}`, { token }, "GET");
+    const completed = Array.isArray(response.results)
+        ? response.results.filter((item) => item.status === "completed").length
+        : 0;
+    return creativeToolResult(response, [
+        "# 爆款视频复刻任务状态",
+        `- 任务 ID: ${response.taskId}`,
+        `- 状态: ${response.status}`,
+        `- 进度: ${response.progress}%`,
+        `- 已完成: ${completed}/${response.count}`,
+        ...(response.status === "completed" ? ["- 视频链接已返回在 results 中"] : []),
+    ]);
+}
+async function handleCreateEcommerceStoryboardTask(apiBaseUrl, token, args) {
+    if (!args || typeof args.productName !== "string" || typeof args.productDescription !== "string") {
+        throw new McpToolError("productName 和 productDescription 不能为空。", "MISSING_PARAMETERS");
+    }
+    const productImage = args.productImage
+        ? (await processFileInput(args.productImage, "image", 5 * 1024 * 1024)).data
+        : undefined;
+    const response = await callRestApi(apiBaseUrl, "/mcp/storyboard/create", {
+        token,
+        productName: args.productName,
+        productDescription: args.productDescription,
+        targetAudience: args.targetAudience,
+        videoStyle: args.videoStyle,
+        productImage,
+        targetDuration: args.targetDuration,
+        language: args.language,
+        orientation: args.orientation,
+        dryRun: args.dryRun === true,
+    }, "POST");
+    const lines = response.dryRun
+        ? [
+            "# 电商视频分镜预检通过",
+            `- 预计积分: ${response.estimatedCredits}`,
+            `- 当前余额: ${response.remainingCredits}`,
+            "- 未上传商品图、未创建任务、未扣费",
+        ]
+        : [
+            "# 电商视频分镜任务已创建",
+            `- 任务 ID: ${response.taskId}`,
+            `- 已扣积分: ${response.creditsDeducted}`,
+            `- ${response.statusHint}`,
+        ];
+    return creativeToolResult(response, lines);
+}
+async function handleGetEcommerceStoryboardStatus(apiBaseUrl, token, args) {
+    if (!Number.isInteger(args?.taskId)) {
+        throw new McpToolError("taskId 必须是整数。", "BAD_REQUEST");
+    }
+    const response = await callRestApi(apiBaseUrl, `/mcp/storyboard/status/${args.taskId}`, { token }, "GET");
+    return creativeToolResult(response, [
+        "# 电商视频分镜任务状态",
+        `- 任务 ID: ${response.taskId}`,
+        `- 状态: ${response.status}`,
+        `- 进度: ${response.progress}%`,
+        `- 分镜数量: ${Array.isArray(response.scenes) ? response.scenes.length : 0}`,
+        ...(response.status === "completed"
+            ? ["- 完整剧情和逐镜 Prompt/插图已返回在 structuredContent 中"]
+            : []),
+    ]);
+}
 /**
  * Call REST API
  *