@infimind/video-mcp-cli 1.0.11 → 1.0.13

package/dist/creativeTools.js

@@ -0,0 +1,585 @@
+const createAnnotations = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: true,
+};
+const statusAnnotations = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+const nullableString = (title, description) => ({
+    type: ["string", "null"],
+    title,
+    description,
+});
+const nullableBoolean = (title, description) => ({
+    type: ["boolean", "null"],
+    title,
+    description,
+});
+const nullableNumber = (title, description) => ({
+    type: ["number", "null"],
+    title,
+    description,
+});
+const structuredErrorProperties = {
+    errorCode: nullableString("错误代码", "处理失败时的机器可读错误代码；未失败时为空。"),
+    errorCategory: nullableString("错误分类", "处理失败时的错误类别；未失败时为空。"),
+    retryable: nullableBoolean("是否可重试", "表示处理失败后是否建议重新创建任务；未失败时为空。"),
+    errorMessage: nullableString("错误信息", "处理失败时的可读原因；未失败时为空。"),
+};
+export const MCP_CREATIVE_TOOLS = [
+    {
+        name: "create_motion_video_remake_task",
+        title: "生成人物动作模仿视频",
+        description: "根据人物图片和动作参考视频创建人物动作模仿或人物替换任务，素材可使用本地文件路径或公网 URL，并可使用 dryRun 预检素材和估算积分。本工具返回 taskId，不直接返回最终视频；创建后请调用 get_motion_video_remake_status 并原样传入 taskId，轮询生成进度和结果。",
+        annotations: createAnnotations,
+        inputSchema: {
+            type: "object",
+            title: "人物动作模仿参数",
+            description: "创建人物动作模仿或人物替换视频任务所需的参考素材和生成配置。",
+            properties: {
+                sourceImage: {
+                    type: "string",
+                    title: "人物参考图片",
+                    description: "必填。包含目标人物的本地 JPG/PNG 图片路径或公网 URL。",
+                },
+                referenceVideo: {
+                    type: "string",
+                    title: "动作参考视频",
+                    description: "必填。包含需要模仿动作的本地 MP4 视频路径或公网 URL。",
+                },
+                mode: {
+                    type: "string",
+                    title: "模仿模式",
+                    enum: ["move", "mix"],
+                    default: "move",
+                    description: "可选。move=让图片人物模仿参考动作，mix=用图片人物替换参考视频中的人物；默认 move。",
+                },
+                quality: {
+                    type: "string",
+                    title: "生成质量",
+                    enum: ["std", "pro"],
+                    default: "std",
+                    description: "可选。std=标准质量，pro=更高质量；默认 std。",
+                },
+                count: {
+                    type: "integer",
+                    title: "生成数量",
+                    minimum: 1,
+                    maximum: 10,
+                    default: 1,
+                    description: "可选。需要生成的视频数量，范围 1–10，默认 1。",
+                },
+                referenceVideoDurationSeconds: {
+                    type: "number",
+                    title: "参考视频时长",
+                    exclusiveMinimum: 0,
+                    maximum: 30,
+                    description: "可选。仅在 dryRun 预检时用于估算积分，单位为秒，须大于 0 且不超过 30；正式创建时由服务检测素材时长。",
+                },
+                dryRun: {
+                    type: "boolean",
+                    title: "仅预检",
+                    default: false,
+                    description: "可选。设为 true 时仅校验素材，并在提供 referenceVideoDurationSeconds 时估算积分，不创建任务且不扣费；默认 false。",
+                },
+            },
+            required: ["sourceImage", "referenceVideo"],
+            additionalProperties: false,
+        },
+        outputSchema: {
+            type: "object",
+            title: "动作模仿任务创建结果",
+            description: "返回任务标识、生成配置、积分信息和后续查询提示；预检或失败时部分字段可能为空或不返回。",
+            properties: {
+                success: {
+                    type: "boolean",
+                    title: "是否成功",
+                    description: "表示任务创建或预检请求是否成功。",
+                },
+                dryRun: {
+                    type: "boolean",
+                    title: "是否仅预检",
+                    description: "表示本次请求是否只进行了预检而未创建任务。",
+                },
+                taskId: {
+                    type: "number",
+                    title: "任务 ID",
+                    description: "创建成功后返回的动作模仿任务 ID；dryRun 或失败时可能不返回，请用于调用 get_motion_video_remake_status。",
+                },
+                mode: {
+                    type: "string",
+                    title: "模仿模式",
+                    description: "本次任务实际使用的模仿模式。",
+                },
+                quality: {
+                    type: "string",
+                    title: "生成质量",
+                    description: "本次任务实际使用的生成质量。",
+                },
+                count: {
+                    type: "number",
+                    title: "生成数量",
+                    description: "本次任务计划生成的视频数量。",
+                },
+                detectedDurationSeconds: nullableNumber("检测视频时长", "服务检测到的参考视频时长，单位为秒；预检或尚未检测时可能为空。"),
+                durationHintSeconds: nullableNumber("提示视频时长", "dryRun 请求提供的参考视频时长，单位为秒；未提供时为空。"),
+                creditsPerVideo: nullableNumber("单个视频积分", "预计生成单个视频所需的积分；无法估算时为空。"),
+                estimatedCredits: nullableNumber("预估总积分", "预计完成全部视频所需的积分；无法估算时为空。"),
+                estimateSource: {
+                    type: "string",
+                    title: "估算依据",
+                    description: "积分估算依据：server_validated=服务检测素材，duration_hint=采用时长提示，unavailable=暂时无法估算。",
+                    enum: ["server_validated", "duration_hint", "unavailable"],
+                },
+                creditsDeducted: {
+                    type: "number",
+                    title: "已扣积分",
+                    description: "本次请求实际扣除的积分；dryRun 时为 0。",
+                },
+                remainingCredits: {
+                    type: "number",
+                    title: "剩余积分",
+                    description: "请求处理后的账户剩余积分。",
+                },
+                validationWarnings: {
+                    type: "array",
+                    title: "预检警告",
+                    description: "参数或素材预检产生的非阻断性提示列表。",
+                    items: {
+                        type: "string",
+                        title: "预检警告项",
+                        description: "一条需要关注但不阻断请求的预检提示。",
+                    },
+                },
+                statusHint: {
+                    type: "string",
+                    title: "后续操作提示",
+                    description: "提示是否应使用 taskId 调用 get_motion_video_remake_status 查询任务进度。",
+                },
+                code: {
+                    type: "string",
+                    title: "错误代码",
+                    description: "请求失败时返回的机器可读错误代码，成功时可能不返回。",
+                },
+                message: {
+                    type: "string",
+                    title: "结果消息",
+                    description: "请求结果或失败原因的可读说明。",
+                },
+            },
+            required: ["success"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "get_motion_video_remake_status",
+        title: "查询动作模仿视频结果",
+        description: "根据 create_motion_video_remake_task 返回的 taskId 查询人物动作模仿视频的进度、视频链接和失败原因。任务未完成时请间隔一段时间后使用同一 taskId 再次调用。",
+        annotations: statusAnnotations,
+        inputSchema: {
+            type: "object",
+            title: "动作模仿任务查询参数",
+            description: "指定需要查询的人物动作模仿任务。",
+            properties: {
+                taskId: {
+                    type: "integer",
+                    title: "任务 ID",
+                    description: "必填。由 create_motion_video_remake_task 返回的任务 ID，请原样传入并用于后续轮询。",
+                },
+            },
+            required: ["taskId"],
+            additionalProperties: false,
+        },
+        outputSchema: {
+            type: "object",
+            title: "动作模仿视频状态与结果",
+            description: "返回任务进度、视频结果和错误信息；任务未完成时结果链接和完成时间可能为空。",
+            properties: {
+                success: {
+                    type: "boolean",
+                    title: "是否成功",
+                    description: "表示查询请求是否成功。",
+                },
+                taskId: {
+                    type: "number",
+                    title: "任务 ID",
+                    description: "当前查询的动作模仿任务 ID。",
+                },
+                status: {
+                    type: "string",
+                    title: "任务状态",
+                    description: "任务当前的处理状态；未完成时应稍后继续查询。",
+                },
+                progress: {
+                    type: "number",
+                    title: "总体进度",
+                    description: "任务总体处理进度，通常为 0–100 的数值。",
+                },
+                mode: {
+                    type: "string",
+                    title: "模仿模式",
+                    description: "任务使用的模仿模式。",
+                },
+                quality: {
+                    type: "string",
+                    title: "生成质量",
+                    description: "任务使用的生成质量。",
+                },
+                count: {
+                    type: "number",
+                    title: "视频数量",
+                    description: "任务计划生成的视频数量。",
+                },
+                videoDuration: {
+                    type: "number",
+                    title: "参考视频时长",
+                    description: "参考动作视频的时长，单位为秒。",
+                },
+                createdAt: {
+                    type: ["string", "null"],
+                    title: "创建时间",
+                    description: "任务创建时间；不可用时为空。",
+                },
+                completedAt: {
+                    type: ["string", "null"],
+                    title: "完成时间",
+                    description: "任务完成时间；未完成时为空。",
+                },
+                ...structuredErrorProperties,
+                results: {
+                    type: "array",
+                    title: "视频结果列表",
+                    description: "每个待生成视频的状态、访问链接和错误信息。",
+                    items: {
+                        type: "object",
+                        title: "动作模仿视频结果",
+                        description: "一个动作模仿视频的处理状态、访问链接、时间和错误信息。",
+                        properties: {
+                            resultId: {
+                                type: "number",
+                                title: "视频结果 ID",
+                                description: "该视频结果在任务中的唯一标识。",
+                            },
+                            status: {
+                                type: "string",
+                                title: "视频状态",
+                                description: "该视频当前的生成状态。",
+                            },
+                            videoUrl: nullableString("视频 URL", "生成完成后的视频访问 URL；未完成或失败时为空。"),
+                            thumbnailUrl: nullableString("缩略图 URL", "视频缩略图访问 URL；尚未生成时为空。"),
+                            createdAt: nullableString("创建时间", "该视频结果的创建时间；不可用时为空。"),
+                            completedAt: nullableString("完成时间", "该视频的完成时间；未完成时为空。"),
+                            ...structuredErrorProperties,
+                        },
+                        required: ["resultId", "status"],
+                        additionalProperties: false,
+                    },
+                },
+                code: {
+                    type: "string",
+                    title: "查询错误代码",
+                    description: "查询请求失败时返回的机器可读错误代码，成功时可能不返回。",
+                },
+                message: {
+                    type: "string",
+                    title: "查询消息",
+                    description: "查询结果或失败原因的可读说明。",
+                },
+            },
+            required: ["success"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "create_ecommerce_storyboard_task",
+        title: "生成电商视频分镜",
+        description: "根据商品信息生成剧情、逐镜描述、镜头提示词和分镜插图，可使用本地商品图片或公网 URL，也可通过 dryRun 预检并估算积分；本工具不直接生成最终视频。本工具返回 taskId，创建后请调用 get_ecommerce_storyboard_status 并原样传入 taskId，轮询分镜进度和结果。",
+        annotations: createAnnotations,
+        inputSchema: {
+            type: "object",
+            title: "电商视频分镜参数",
+            description: "创建电商视频分镜任务所需的商品信息和内容配置。",
+            properties: {
+                productName: {
+                    type: "string",
+                    title: "商品名称",
+                    description: "必填。需要创作电商视频分镜的商品名称。",
+                },
+                productDescription: {
+                    type: "string",
+                    title: "商品描述",
+                    description: "必填。描述商品功能、核心卖点、使用场景和希望强调的信息。",
+                },
+                targetAudience: {
+                    type: "string",
+                    title: "目标受众",
+                    description: "可选。视频希望触达的人群特征，用于调整剧情和表达方式。",
+                },
+                videoStyle: {
+                    type: "string",
+                    title: "视频风格",
+                    description: "可选。期望的视觉、叙事或营销风格。",
+                },
+                productImage: {
+                    type: "string",
+                    title: "商品图片",
+                    description: "可选。展示商品的本地 JPG/PNG/WebP 图片路径或公网 URL。",
+                },
+                targetDuration: {
+                    type: "integer",
+                    title: "目标时长",
+                    enum: [30, 60, 90, 120],
+                    default: 60,
+                    description: "可选。计划成片的目标时长，单位为秒，可选 30、60、90 或 120，默认 60。",
+                },
+                language: {
+                    type: "string",
+                    title: "内容输出语言",
+                    enum: ["zh-CN", "en"],
+                    default: "zh-CN",
+                    description: "可选。剧情、镜头描述和提示词的输出语言；zh-CN=简体中文，en=英文，默认 zh-CN。",
+                },
+                orientation: {
+                    type: "string",
+                    title: "画面方向",
+                    enum: ["horizontal", "vertical"],
+                    default: "horizontal",
+                    description: "可选。horizontal=横屏，vertical=竖屏；默认 horizontal。",
+                },
+                dryRun: {
+                    type: "boolean",
+                    title: "仅预检",
+                    default: false,
+                    description: "可选。设为 true 时仅校验参数并预估 2 积分，不创建任务且不扣费；默认 false。",
+                },
+            },
+            required: ["productName", "productDescription"],
+            additionalProperties: false,
+        },
+        outputSchema: {
+            type: "object",
+            title: "电商分镜任务创建结果",
+            description: "返回任务标识、积分信息和后续查询提示；预检或失败时部分字段可能不返回。",
+            properties: {
+                success: {
+                    type: "boolean",
+                    title: "是否成功",
+                    description: "表示任务创建或预检请求是否成功。",
+                },
+                dryRun: {
+                    type: "boolean",
+                    title: "是否仅预检",
+                    description: "表示本次请求是否只进行了预检而未创建任务。",
+                },
+                taskId: {
+                    type: "number",
+                    title: "任务 ID",
+                    description: "创建成功后返回的电商分镜任务 ID；dryRun 或失败时可能不返回，请用于调用 get_ecommerce_storyboard_status。",
+                },
+                estimatedCredits: {
+                    type: "number",
+                    title: "预估积分",
+                    description: "完成本次分镜任务预计需要的积分。",
+                },
+                creditsDeducted: {
+                    type: "number",
+                    title: "已扣积分",
+                    description: "本次请求实际扣除的积分；dryRun 时为 0。",
+                },
+                remainingCredits: {
+                    type: "number",
+                    title: "剩余积分",
+                    description: "请求处理后的账户剩余积分。",
+                },
+                validationWarnings: {
+                    type: "array",
+                    title: "预检警告",
+                    description: "参数或素材预检产生的非阻断性提示列表。",
+                    items: {
+                        type: "string",
+                        title: "预检警告项",
+                        description: "一条需要关注但不阻断请求的预检提示。",
+                    },
+                },
+                statusHint: {
+                    type: "string",
+                    title: "后续操作提示",
+                    description: "提示是否应使用 taskId 调用 get_ecommerce_storyboard_status 查询分镜进度。",
+                },
+                code: {
+                    type: "string",
+                    title: "错误代码",
+                    description: "请求失败时返回的机器可读错误代码，成功时可能不返回。",
+                },
+                message: {
+                    type: "string",
+                    title: "结果消息",
+                    description: "请求结果或失败原因的可读说明。",
+                },
+            },
+            required: ["success"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "get_ecommerce_storyboard_status",
+        title: "查询电商视频分镜结果",
+        description: "根据 create_ecommerce_storyboard_task 返回的 taskId 查询电商视频分镜的处理进度、剧情、逐镜描述、镜头提示词和分镜插图。任务未完成时请间隔一段时间后使用同一 taskId 再次调用。",
+        annotations: statusAnnotations,
+        inputSchema: {
+            type: "object",
+            title: "电商分镜任务查询参数",
+            description: "指定需要查询的电商视频分镜任务。",
+            properties: {
+                taskId: {
+                    type: "integer",
+                    title: "任务 ID",
+                    description: "必填。由 create_ecommerce_storyboard_task 返回的任务 ID，请原样传入并用于后续轮询。",
+                },
+            },
+            required: ["taskId"],
+            additionalProperties: false,
+        },
+        outputSchema: {
+            type: "object",
+            title: "电商视频分镜状态与结果",
+            description: "返回分镜任务进度、剧情、逐镜内容、插图和错误信息；任务未完成时内容可能为空。",
+            properties: {
+                success: {
+                    type: "boolean",
+                    title: "是否成功",
+                    description: "表示查询请求是否成功。",
+                },
+                taskId: {
+                    type: "number",
+                    title: "任务 ID",
+                    description: "当前查询的电商分镜任务 ID。",
+                },
+                status: {
+                    type: "string",
+                    title: "任务状态",
+                    description: "分镜任务当前的处理状态；未完成时应稍后继续查询。",
+                },
+                progress: {
+                    type: "number",
+                    title: "总体进度",
+                    description: "任务总体处理进度，通常为 0–100 的数值。",
+                },
+                fullStory: {
+                    type: ["string", "null"],
+                    title: "完整剧情",
+                    description: "根据商品信息生成的完整视频剧情；任务未完成时为空。",
+                },
+                targetDuration: {
+                    type: "number",
+                    title: "目标时长",
+                    description: "计划成片的目标时长，单位为秒。",
+                },
+                language: {
+                    type: "string",
+                    title: "内容输出语言",
+                    description: "剧情、镜头描述和提示词使用的语言。",
+                },
+                orientation: {
+                    type: "string",
+                    title: "画面方向",
+                    description: "分镜采用的横屏或竖屏方向。",
+                },
+                createdAt: {
+                    type: ["string", "null"],
+                    title: "创建时间",
+                    description: "任务创建时间；不可用时为空。",
+                },
+                completedAt: {
+                    type: ["string", "null"],
+                    title: "完成时间",
+                    description: "任务完成时间；未完成时为空。",
+                },
+                scenes: {
+                    type: "array",
+                    title: "分镜列表",
+                    description: "按场景顺序返回的逐镜内容和插图生成状态。",
+                    items: {
+                        type: "object",
+                        title: "分镜场景",
+                        description: "一个分镜场景的描述、时长、生成提示词、插图和错误信息。",
+                        properties: {
+                            sceneIndex: {
+                                type: "number",
+                                title: "场景序号",
+                                description: "该分镜场景在完整剧情中的顺序编号。",
+                            },
+                            description: {
+                                type: "string",
+                                title: "场景描述",
+                                description: "该场景的画面内容、人物动作和叙事说明。",
+                            },
+                            duration: {
+                                type: "number",
+                                title: "场景时长",
+                                description: "该场景建议持续的时间，单位为秒。",
+                            },
+                            prompt: {
+                                type: "string",
+                                title: "镜头提示词",
+                                description: "用于后续生成该场景画面的提示词。",
+                            },
+                            sketchImageUrl: nullableString("分镜插图 URL", "该场景分镜插图的访问 URL；插图未完成或失败时为空。"),
+                            imageGenerationStatus: {
+                                type: "string",
+                                title: "插图生成状态",
+                                description: "该场景分镜插图当前的生成状态。",
+                            },
+                            ...structuredErrorProperties,
+                        },
+                        required: [
+                            "sceneIndex",
+                            "description",
+                            "duration",
+                            "prompt",
+                            "imageGenerationStatus",
+                        ],
+                        additionalProperties: false,
+                    },
+                },
+                errorMessage: {
+                    type: ["string", "null"],
+                    title: "任务错误信息",
+                    description: "分镜任务失败时的可读原因；未失败时为空。",
+                },
+                errorCode: {
+                    type: ["string", "null"],
+                    title: "任务错误代码",
+                    description: "分镜任务失败时的机器可读错误代码；未失败时为空。",
+                },
+                errorCategory: {
+                    type: ["string", "null"],
+                    title: "任务错误分类",
+                    description: "分镜任务失败时的错误类别；未失败时为空。",
+                },
+                retryable: {
+                    type: ["boolean", "null"],
+                    title: "任务是否可重试",
+                    description: "表示任务失败后是否建议重新创建；未失败时为空。",
+                },
+                code: {
+                    type: "string",
+                    title: "查询错误代码",
+                    description: "查询请求失败时返回的机器可读错误代码，成功时可能不返回。",
+                },
+                message: {
+                    type: "string",
+                    title: "查询消息",
+                    description: "查询结果或失败原因的可读说明。",
+                },
+            },
+            required: ["success"],
+            additionalProperties: false,
+        },
+    },
+];