@idk500/video-vision-mcp 1.2.0

package/dist/index.js

@@ -0,0 +1,813 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { HunyuanClient } from './hunyuan-client.js';
+import { VideoProcessor } from './video-processor.js';
+import { FrameExtractor } from './frame-extractor.js';
+class VideoMCPServer {
+    server;
+    videoProcessor;
+    frameExtractor;
+    // The OpenAI-compatible API key for the vision/text backend. Historically
+    // held Tencent credentials; now it is a single bearer token (e.g. Bigmodel).
+    secretId;
+    secretKey;
+    region;
+    constructor(options) {
+        // 视觉/文本后端的 API Key。优先级：环境变量 > 启动参数。
+        // 兼容历史变量名 TENCENT_SECRET_ID/KEY，同时接受 VISION_API_KEY。
+        this.secretId =
+            process.env.VISION_API_KEY || process.env.TENCENT_SECRET_ID || options?.secretId;
+        this.secretKey = process.env.TENCENT_SECRET_KEY || options?.secretKey;
+        this.region = process.env.VISION_ENDPOINT || process.env.TENCENT_REGION || options?.region;
+        this.server = new Server({
+            name: 'video-mcp',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.videoProcessor = new VideoProcessor();
+        this.frameExtractor = new FrameExtractor();
+        this.setupToolHandlers();
+    }
+    setupToolHandlers() {
+        // 列出所有可用工具
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return {
+                tools: [
+                    {
+                        name: 'extract_video_frames',
+                        description: '从视频中提取关键帧图像',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                videoPath: {
+                                    type: 'string',
+                                    description: '视频文件路径',
+                                },
+                                maxFrames: {
+                                    type: 'number',
+                                    description: '最大提取帧数（默认10帧）',
+                                    default: 10,
+                                },
+                                outputDir: {
+                                    type: 'string',
+                                    description: '输出目录路径（可选）',
+                                },
+                                strategy: {
+                                    type: 'string',
+                                    enum: ['uniform', 'keyframe', 'scene_change'],
+                                    description: '提取策略：uniform(均匀间隔), keyframe(关键帧), scene_change(场景变化)',
+                                    default: 'uniform',
+                                },
+                            },
+                            required: ['videoPath'],
+                        },
+                    },
+                    {
+                        name: 'analyze_video_content',
+                        description: '使用视觉模型分析视频内容（抽帧后送入多模态模型）',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                videoPath: {
+                                    type: 'string',
+                                    description: '视频文件路径',
+                                },
+                                prompt: {
+                                    type: 'string',
+                                    description: '分析提示词（可选）',
+                                    default: '请基于这些视频关键帧，用100-200字简洁描述视频的主要内容、场景、人物和动作，不需要逐帧分析。',
+                                },
+                                maxFrames: {
+                                    type: 'number',
+                                    description: '最大分析帧数（默认5帧以控制成本）',
+                                    default: 5,
+                                },
+                                strategy: {
+                                    type: 'string',
+                                    enum: ['uniform', 'keyframe', 'scene_change'],
+                                    description: '帧提取策略',
+                                    default: 'keyframe',
+                                },
+                                secretId: {
+                                    type: 'string',
+                                    description: '视觉模型 API Key（可选，优先使用环境变量 VISION_API_KEY）',
+                                },
+                                secretKey: {
+                                    type: 'string',
+                                    description: '保留字段（视觉模型仅需 secretId/apiKey），可选',
+                                },
+                                region: {
+                                    type: 'string',
+                                    description: '视觉模型端点 baseURL（可选，默认智谱 Bigmodel paas/v4）',
+                                },
+                            },
+                            required: ['videoPath'],
+                        },
+                    },
+                    {
+                        name: 'analyze_image_batch',
+                        description: '批量分析图片内容',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                imagePaths: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: '图片文件路径数组',
+                                },
+                                prompt: {
+                                    type: 'string',
+                                    description: '分析提示词（可选）',
+                                    default: '请描述这张图片的内容。',
+                                },
+                                secretId: {
+                                    type: 'string',
+                                    description: '视觉模型 API Key（可选，优先使用环境变量 VISION_API_KEY）',
+                                },
+                                secretKey: {
+                                    type: 'string',
+                                    description: '保留字段（视觉模型仅需 secretId/apiKey），可选',
+                                },
+                                region: {
+                                    type: 'string',
+                                    description: '视觉模型端点 baseURL（可选，默认智谱 Bigmodel paas/v4）',
+                                },
+                            },
+                            required: ['imagePaths'],
+                        },
+                    },
+                    {
+                        name: 'get_video_info',
+                        description: '获取视频文件基本信息',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                videoPath: {
+                                    type: 'string',
+                                    description: '视频文件路径',
+                                },
+                            },
+                            required: ['videoPath'],
+                        },
+                    },
+                    {
+                        name: 'generate_video_script',
+                        description: '基于视频内容生成专业拍摄脚本',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                videoPath: {
+                                    type: 'string',
+                                    description: '视频文件路径',
+                                },
+                                prompt: {
+                                    type: 'string',
+                                    description: '自定义脚本生成要求（可选）',
+                                },
+                                maxFrames: {
+                                    type: 'number',
+                                    description: '最大分析帧数（默认5帧以控制成本）',
+                                    default: 5,
+                                },
+                                strategy: {
+                                    type: 'string',
+                                    enum: ['uniform', 'keyframe', 'scene_change'],
+                                    description: '帧提取策略',
+                                    default: 'keyframe',
+                                },
+                                scriptType: {
+                                    type: 'string',
+                                    enum: ['commercial', 'documentary', 'tutorial', 'narrative', 'custom'],
+                                    description: '脚本类型：commercial(商业广告), documentary(纪录片), tutorial(教学), narrative(叙事), custom(自定义)',
+                                    default: 'commercial',
+                                },
+                                targetDuration: {
+                                    type: 'number',
+                                    description: '目标脚本时长（秒）',
+                                },
+                                targetAudience: {
+                                    type: 'string',
+                                    description: '目标受众（默认：一般观众）',
+                                    default: '一般观众',
+                                },
+                                style: {
+                                    type: 'string',
+                                    description: '拍摄风格（默认：专业、吸引人）',
+                                    default: '专业、吸引人',
+                                },
+                                secretId: {
+                                    type: 'string',
+                                    description: '视觉模型 API Key（可选，优先使用环境变量 VISION_API_KEY）',
+                                },
+                                secretKey: {
+                                    type: 'string',
+                                    description: '保留字段（视觉模型仅需 secretId/apiKey），可选',
+                                },
+                                region: {
+                                    type: 'string',
+                                    description: '视觉模型端点 baseURL（可选，默认智谱 Bigmodel paas/v4）',
+                                },
+                            },
+                            required: ['videoPath'],
+                        },
+                    },
+                    {
+                        name: 'generate_image_script',
+                        description: '基于批量图片内容生成专业拍摄脚本',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                imagePaths: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: '图片文件路径数组',
+                                },
+                                prompt: {
+                                    type: 'string',
+                                    description: '自定义脚本生成要求（可选）',
+                                },
+                                scriptType: {
+                                    type: 'string',
+                                    enum: ['commercial', 'documentary', 'tutorial', 'narrative', 'custom'],
+                                    description: '脚本类型：commercial(商业广告), documentary(纪录片), tutorial(教学), narrative(叙事), custom(自定义)',
+                                    default: 'commercial',
+                                },
+                                targetDuration: {
+                                    type: 'number',
+                                    description: '目标脚本时长（秒）',
+                                },
+                                targetAudience: {
+                                    type: 'string',
+                                    description: '目标受众（默认：一般观众）',
+                                    default: '一般观众',
+                                },
+                                style: {
+                                    type: 'string',
+                                    description: '拍摄风格（默认：专业、吸引人）',
+                                    default: '专业、吸引人',
+                                },
+                                secretId: {
+                                    type: 'string',
+                                    description: '视觉模型 API Key（可选，优先使用环境变量 VISION_API_KEY）',
+                                },
+                                secretKey: {
+                                    type: 'string',
+                                    description: '保留字段（视觉模型仅需 secretId/apiKey），可选',
+                                },
+                                region: {
+                                    type: 'string',
+                                    description: '视觉模型端点 baseURL（可选，默认智谱 Bigmodel paas/v4）',
+                                },
+                            },
+                            required: ['imagePaths'],
+                        },
+                    },
+                ],
+            };
+        });
+        // 处理工具调用
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                switch (name) {
+                    case 'extract_video_frames':
+                        return await this.handleExtractFrames(args);
+                    case 'analyze_video_content':
+                        return await this.handleAnalyzeVideo(args);
+                    case 'analyze_image_batch':
+                        return await this.handleAnalyzeImageBatch(args);
+                    case 'get_video_info':
+                        return await this.handleGetVideoInfo(args);
+                    case 'generate_video_script':
+                        return await this.handleGenerateVideoScript(args);
+                    case 'generate_image_script':
+                        return await this.handleGenerateImageScript(args);
+                    default:
+                        throw new Error(`未知的工具: ${name}。支持的工具包括: extract_video_frames, analyze_video_content, analyze_image_batch, get_video_info, generate_video_script, generate_image_script`);
+                }
+            }
+            catch (error) {
+                const errorMessage = this.formatError(error, name, args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: errorMessage,
+                        },
+                    ],
+                };
+            }
+        });
+    }
+    formatError(error, toolName, args) {
+        const baseError = error instanceof Error ? error.message : String(error);
+        // 构建上下文信息
+        let contextInfo = `\n\n[错误上下文]`;
+        contextInfo += `\n- 工具名称: ${toolName}`;
+        // 添加参数信息（隐藏敏感信息）
+        const sanitizedArgs = { ...args };
+        if (sanitizedArgs.secretId) {
+            sanitizedArgs.secretId = `***${sanitizedArgs.secretId.slice(-4)}`;
+        }
+        if (sanitizedArgs.secretKey) {
+            sanitizedArgs.secretKey = '***hidden***';
+        }
+        contextInfo += `\n- 调用参数: ${JSON.stringify(sanitizedArgs, null, 2)}`;
+        // 根据不同的错误类型提供具体的解决建议
+        let suggestions = `\n\n[解决建议]`;
+        if (baseError.includes('API Key 缺失') || baseError.includes('身份验证失败')) {
+            suggestions += `\n1. 检查 VISION_API_KEY 环境变量或 secretId 参数是否设置了正确的 API Key`;
+            suggestions += `\n2. 确认密钥未过期、未被禁用`;
+            suggestions += `\n3. 在 https://open.bigmodel.cn/usercenter/apikeys 重新生成密钥`;
+        }
+        else if (baseError.includes('访问量过大') || baseError.includes('429') || baseError.includes('调用频率')) {
+            suggestions += `\n1. 免费视觉模型 glm-4.6v-flash 有限流，稍等片刻后重试`;
+            suggestions += `\n2. 减少抽帧数量（maxFrames）以降低单次请求数`;
+            suggestions += `\n3. 如需更高配额，在 Bigmodel 控制台升级套餐`;
+        }
+        else if (baseError.includes('No such file') || baseError.includes('不存在')) {
+            suggestions += `\n1. 检查文件路径是否正确`;
+            suggestions += `\n2. 确认文件是否存在`;
+            suggestions += `\n3. 检查文件权限是否允许读取`;
+        }
+        else if (baseError.includes('ffmpeg') || baseError.includes('Failed to get video info')) {
+            suggestions += `\n1. 检查 FFmpeg 是否正确安装`;
+            suggestions += `\n2. 确认视频文件格式是否受支持`;
+            suggestions += `\n3. 检查视频文件是否损坏`;
+            suggestions += `\n4. 尝试使用其他视频格式进行测试`;
+        }
+        else if (baseError.includes('网络') || baseError.includes('timeout') || baseError.includes('ECONNREFUSED')) {
+            suggestions += `\n1. 检查网络连接是否正常`;
+            suggestions += `\n2. 确认防火墙设置不会阻止API调用`;
+            suggestions += `\n3. 尝试稍后重试`;
+            suggestions += `\n4. 检查代理设置（如果使用代理）`;
+        }
+        else {
+            suggestions += `\n1. 检查所有输入参数是否正确`;
+            suggestions += `\n2. 查看详细错误信息确定问题所在`;
+            suggestions += `\n3. 如果问题持续，请联系技术支持`;
+        }
+        return `❌ 操作失败: ${baseError}${contextInfo}${suggestions}`;
+    }
+    async handleExtractFrames(args) {
+        const { videoPath, maxFrames = 10, outputDir, strategy = 'uniform' } = args;
+        try {
+            // 参数验证
+            if (!videoPath) {
+                throw new Error('视频路径参数(videoPath)是必需的');
+            }
+            // 检查文件是否存在
+            const fs = await import('fs/promises');
+            try {
+                await fs.access(videoPath);
+            }
+            catch {
+                throw new Error(`视频文件不存在或无法访问: ${videoPath}`);
+            }
+            console.error(`开始提取视频帧: ${videoPath}`);
+            console.error(`参数设置 - 最大帧数: ${maxFrames}, 策略: ${strategy}`);
+            const frames = await this.frameExtractor.extractFrames(videoPath, {
+                maxFrames,
+                outputDir,
+                strategy,
+            });
+            if (frames.length === 0) {
+                throw new Error('未能从视频中提取到任何帧，请检查视频文件是否有效');
+            }
+            console.error(`成功提取 ${frames.length} 个视频帧`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ 成功从视频中提取了 ${frames.length} 个帧: ${videoPath}`,
+                    },
+                    {
+                        type: 'text',
+                        text: `📁 帧文件路径:\n${frames.map((frame, index) => `${index + 1}. ${frame}`).join('\n')}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error(`视频帧提取失败:`, error);
+            throw error;
+        }
+    }
+    async handleAnalyzeVideo(args) {
+        const { videoPath, prompt, maxFrames = 5, strategy = 'keyframe', secretId, secretKey, region } = args;
+        try {
+            // 参数验证
+            if (!videoPath) {
+                throw new Error('视频路径参数(videoPath)是必需的');
+            }
+            // 优先使用环境变量，其次使用参数中的密钥，最后使用构造函数中的密钥
+            const finalSecretId = process.env.VISION_API_KEY || process.env.TENCENT_SECRET_ID || secretId || this.secretId;
+            const finalSecretKey = secretKey || this.secretKey;
+            const finalRegion = process.env.VISION_ENDPOINT || region || this.region;
+            if (!finalSecretId) {
+                throw new Error(`视觉模型 API Key 缺失。请通过以下方式之一提供：
+1. 环境变量：VISION_API_KEY
+2. 启动参数：--secret-id <key>
+3. 调用参数：secretId（即 API Key）
+
+默认后端：智谱 Bigmodel glm-4.6v-flash（OpenAI 兼容）。获取 key：https://open.bigmodel.cn/usercenter/apikeys`);
+            }
+            // 检查文件是否存在
+            const fs = await import('fs/promises');
+            try {
+                await fs.access(videoPath);
+            }
+            catch {
+                throw new Error(`视频文件不存在或无法访问: ${videoPath}`);
+            }
+            console.error(`开始分析视频内容: ${videoPath}`);
+            console.error(`分析参数 - 最大帧数: ${maxFrames}, 策略: ${strategy}, 地域: ${finalRegion}`);
+            const result = await this.videoProcessor.analyzeVideo(videoPath, {
+                prompt,
+                maxFrames,
+                strategy,
+                secretId: finalSecretId,
+                secretKey: finalSecretKey,
+                region: finalRegion,
+            });
+            console.error(`视频分析完成`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ 视频内容分析完成: ${videoPath}`,
+                    },
+                    {
+                        type: 'text',
+                        text: `📋 视频内容总结:\n${result.summary}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error(`视频分析失败:`, error);
+            throw error;
+        }
+    }
+    async handleAnalyzeImageBatch(args) {
+        const { imagePaths, prompt, secretId, secretKey, region } = args;
+        try {
+            // 参数验证
+            if (!imagePaths || !Array.isArray(imagePaths) || imagePaths.length === 0) {
+                throw new Error('图片路径数组参数(imagePaths)是必需的，且不能为空');
+            }
+            // 优先使用环境变量，其次使用参数中的密钥，最后使用构造函数中的密钥
+            const finalSecretId = process.env.VISION_API_KEY || process.env.TENCENT_SECRET_ID || secretId || this.secretId;
+            const finalSecretKey = secretKey || this.secretKey;
+            const finalRegion = process.env.VISION_ENDPOINT || region || this.region;
+            if (!finalSecretId) {
+                throw new Error(`视觉模型 API Key 缺失。请通过以下方式之一提供：
+1. 环境变量：VISION_API_KEY
+2. 启动参数：--secret-id <key>
+3. 调用参数：secretId（即 API Key）
+
+默认后端：智谱 Bigmodel glm-4.6v-flash（OpenAI 兼容）。获取 key：https://open.bigmodel.cn/usercenter/apikeys`);
+            }
+            // 检查所有图片文件是否存在
+            const fs = await import('fs/promises');
+            const invalidPaths = [];
+            for (const imagePath of imagePaths) {
+                try {
+                    await fs.access(imagePath);
+                }
+                catch {
+                    invalidPaths.push(imagePath);
+                }
+            }
+            if (invalidPaths.length > 0) {
+                throw new Error(`以下图片文件不存在或无法访问:\n${invalidPaths.join('\n')}`);
+            }
+            console.error(`开始批量分析图片，共 ${imagePaths.length} 张图片`);
+            console.error(`视觉后端端点: ${finalRegion || '(默认智谱 Bigmodel)'}`);
+            const hunyuanClient = new HunyuanClient({
+                secretId: finalSecretId,
+                secretKey: finalSecretKey,
+                region: finalRegion,
+            });
+            const results = await hunyuanClient.analyzeImageBatch(imagePaths, prompt);
+            const successCount = results.filter((result) => !result.content.startsWith('Error')).length;
+            const totalTokens = results.reduce((sum, result) => sum + result.usage.totalTokens, 0);
+            console.error(`批量图片分析完成 - 成功: ${successCount}/${results.length}, 总计使用 ${totalTokens} 个token`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ 批量图片分析完成`,
+                    },
+                    {
+                        type: 'text',
+                        text: `📊 分析统计:\n- 总图片数: ${imagePaths.length}\n- 成功分析: ${successCount}\n- 失败数量: ${imagePaths.length - successCount}\n- Token使用: ${totalTokens}`,
+                    },
+                    {
+                        type: 'text',
+                        text: `🖼️ 详细分析结果:`,
+                    },
+                    ...results.map((result, index) => ({
+                        type: 'text',
+                        text: `\n📸 图片 ${index + 1} (${imagePaths[index]}):\n${result.content}`,
+                    })),
+                ],
+            };
+        }
+        catch (error) {
+            console.error(`批量图片分析失败:`, error);
+            throw error;
+        }
+    }
+    async handleGetVideoInfo(args) {
+        const { videoPath } = args;
+        try {
+            // 参数验证
+            if (!videoPath) {
+                throw new Error('视频路径参数(videoPath)是必需的');
+            }
+            // 检查文件是否存在
+            const fs = await import('fs/promises');
+            try {
+                await fs.access(videoPath);
+            }
+            catch {
+                throw new Error(`视频文件不存在或无法访问: ${videoPath}`);
+            }
+            console.error(`获取视频信息: ${videoPath}`);
+            const info = await this.videoProcessor.getVideoInfo(videoPath);
+            console.error(`视频信息获取完成 - 时长: ${info.duration}s, 分辨率: ${info.width}x${info.height}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ 视频信息获取成功: ${videoPath}`,
+                    },
+                    {
+                        type: 'text',
+                        text: `📹 视频详细信息:`,
+                    },
+                    {
+                        type: 'text',
+                        text: `⏱️  时长: ${info.duration.toFixed(2)} 秒 (${Math.floor(info.duration / 60)}分${Math.floor(info.duration % 60)}秒)`,
+                    },
+                    {
+                        type: 'text',
+                        text: `📐 分辨率: ${info.width} × ${info.height} 像素`,
+                    },
+                    {
+                        type: 'text',
+                        text: `🎞️  帧率: ${info.frameRate.toFixed(2)} fps`,
+                    },
+                    {
+                        type: 'text',
+                        text: `🎬 总帧数: ${info.frameCount} 帧`,
+                    },
+                    {
+                        type: 'text',
+                        text: `📁 格式: ${info.format}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error(`获取视频信息失败:`, error);
+            throw error;
+        }
+    }
+    async handleGenerateVideoScript(args) {
+        const { videoPath, prompt, maxFrames = 5, strategy = 'keyframe', scriptType = 'commercial', targetDuration, targetAudience = '一般观众', style = '专业、吸引人', secretId, secretKey, region } = args;
+        try {
+            // 参数验证
+            if (!videoPath) {
+                throw new Error('视频路径参数(videoPath)是必需的');
+            }
+            // 优先使用环境变量，其次使用参数中的密钥，最后使用构造函数中的密钥
+            const finalSecretId = process.env.VISION_API_KEY || process.env.TENCENT_SECRET_ID || secretId || this.secretId;
+            const finalSecretKey = secretKey || this.secretKey;
+            const finalRegion = process.env.VISION_ENDPOINT || region || this.region;
+            if (!finalSecretId) {
+                throw new Error(`视觉模型 API Key 缺失。请通过以下方式之一提供：
+1. 环境变量：VISION_API_KEY
+2. 启动参数：--secret-id <key>
+3. 调用参数：secretId（即 API Key）
+
+默认后端：智谱 Bigmodel glm-4.6v-flash（OpenAI 兼容）。获取 key：https://open.bigmodel.cn/usercenter/apikeys`);
+            }
+            // 检查文件是否存在
+            const fs = await import('fs/promises');
+            try {
+                await fs.access(videoPath);
+            }
+            catch {
+                throw new Error(`视频文件不存在或无法访问: ${videoPath}`);
+            }
+            console.error(`开始生成视频拍摄脚本: ${videoPath}`);
+            console.error(`脚本参数 - 类型: ${scriptType}, 最大帧数: ${maxFrames}, 策略: ${strategy}, 目标受众: ${targetAudience}`);
+            const scriptOptions = {
+                prompt,
+                maxFrames,
+                strategy,
+                scriptType,
+                targetDuration,
+                targetAudience,
+                style,
+                secretId: finalSecretId,
+                secretKey: finalSecretKey,
+                region: finalRegion,
+            };
+            const result = await this.videoProcessor.generateVideoScript(videoPath, scriptOptions);
+            console.error(`视频脚本生成完成 - 总Token使用: ${result.usage.totalTokens} (分析: ${result.usage.analysisTokens}, 脚本: ${result.usage.scriptTokens})`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ 视频拍摄脚本生成完成: ${videoPath}`,
+                    },
+                    {
+                        type: 'text',
+                        text: `📊 Token使用统计:
+- 视频分析: ${result.usage.analysisTokens} tokens
+- 脚本生成: ${result.usage.scriptTokens} tokens  
+- 总计: ${result.usage.totalTokens} tokens`,
+                    },
+                    {
+                        type: 'text',
+                        text: `🎬 专业拍摄脚本:
+${result.script}`,
+                    },
+                    {
+                        type: 'text',
+                        text: `📝 原始视频分析:
+${result.videoAnalysis}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error(`视频脚本生成失败:`, error);
+            throw error;
+        }
+    }
+    async handleGenerateImageScript(args) {
+        const { imagePaths, prompt, scriptType = 'commercial', targetDuration, targetAudience = '一般观众', style = '专业、吸引人', secretId, secretKey, region } = args;
+        try {
+            // 参数验证
+            if (!imagePaths || !Array.isArray(imagePaths) || imagePaths.length === 0) {
+                throw new Error('图片路径数组参数(imagePaths)是必需的，且不能为空');
+            }
+            // 视觉/文本后端 API Key。优先环境变量，其次调用参数，最后构造函数。
+            const finalSecretId = process.env.VISION_API_KEY || process.env.TENCENT_SECRET_ID || secretId || this.secretId;
+            const finalSecretKey = secretKey || this.secretKey;
+            const finalRegion = process.env.VISION_ENDPOINT || region || this.region;
+            if (!finalSecretId) {
+                throw new Error('视觉模型 API Key 缺失。请通过以下方式之一提供：\n'
+                    + '1. 环境变量：VISION_API_KEY\n'
+                    + '2. 启动参数：--secret-id <key>\n'
+                    + '3. 调用参数：secretId（即 API Key）\n\n'
+                    + '默认后端：智谱 Bigmodel glm-4.6v-flash（OpenAI 兼容）。'
+                    + '获取 key：https://open.bigmodel.cn/usercenter/apikeys');
+            }
+            // 检查所有图片文件是否存在
+            const fs = await import('fs/promises');
+            const invalidPaths = [];
+            for (const imagePath of imagePaths) {
+                try {
+                    await fs.access(imagePath);
+                }
+                catch {
+                    invalidPaths.push(imagePath);
+                }
+            }
+            if (invalidPaths.length > 0) {
+                throw new Error('以下图片文件不存在或无法访问：\
+' + invalidPaths.join('\
+'));
+            }
+            console.error('开始基于 ' + imagePaths.length + ' 张图片生成拍摄脚本');
+            console.error('脚本参数 - 类型: ' + scriptType + ', 目标受众: ' + targetAudience + ', 风格: ' + style);
+            const result = await this.videoProcessor.generateImageScript(imagePaths, {
+                prompt,
+                scriptType,
+                targetDuration,
+                targetAudience,
+                style,
+                secretId: finalSecretId,
+                secretKey: finalSecretKey,
+                region: finalRegion,
+            });
+            console.error('图片脚本生成完成 - 总Token使用: ' + result.usage.totalTokens + ' (分析: ' + result.usage.analysisTokens + ', 脚本: ' + result.usage.scriptTokens + ')');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: '✅ 基于图片的拍摄脚本生成完成',
+                    },
+                    {
+                        type: 'text',
+                        text: '📊 处理统计：\
+- 图片数量: ' + imagePaths.length + '\
+- 脚本类型: ' + scriptType + '\
+- 目标受众: ' + targetAudience,
+                    },
+                    {
+                        type: 'text',
+                        text: '📊 Token使用统计:\
+- 图片分析: ' + result.usage.analysisTokens + ' tokens\
+- 脚本生成: ' + result.usage.scriptTokens + ' tokens\
+- 总计: ' + result.usage.totalTokens + ' tokens',
+                    },
+                    {
+                        type: 'text',
+                        text: '🎬 专业拍摄脚本:\
+' + result.script,
+                    },
+                    {
+                        type: 'text',
+                        text: '📝 原始图片分析:\
+' + result.imageAnalysis,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            console.error('图片脚本生成失败:', error);
+            throw error;
+        }
+    }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error('Video MCP Server running on stdio');
+    }
+}
+async function main() {
+    // 解析命令行参数
+    const args = process.argv.slice(2);
+    const options = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const nextArg = args[i + 1];
+        switch (arg) {
+            case '--secret-id':
+                if (nextArg && !nextArg.startsWith('--')) {
+                    options.secretId = nextArg;
+                    i++; // 跳过下一个参数，因为它是值
+                }
+                break;
+            case '--secret-key':
+                if (nextArg && !nextArg.startsWith('--')) {
+                    options.secretKey = nextArg;
+                    i++; // 跳过下一个参数，因为它是值
+                }
+                break;
+            case '--region':
+                if (nextArg && !nextArg.startsWith('--')) {
+                    options.region = nextArg;
+                    i++; // 跳过下一个参数，因为它是值
+                }
+                break;
+            case '--help':
+            case '-h':
+                console.error(`
+Video MCP Server - 视频处理和分析服务
+
+用法:
+  node dist/index.js [选项]
+
+选项:
+  --secret-id <key>    视觉模型 API Key（也可用环境变量 VISION_API_KEY）
+  --secret-key <key>   保留字段（OpenAI 兼容后端不需要）
+  --region <url>       视觉模型端点 baseURL（默认智谱 Bigmodel paas/v4）
+  --help, -h           显示帮助信息
+
+环境变量:
+  VISION_API_KEY       视觉/文本模型 API Key
+  VISION_ENDPOINT      端点 baseURL（默认 https://open.bigmodel.cn/api/paas/v4）
+  VISION_MODEL         视觉模型名（默认 glm-4.6v-flash）
+  TEXT_MODEL           文本模型名（默认 glm-4.6）
+
+示例:
+  node dist/index.js --secret-id=your-api-key
+        `);
+                process.exit(0);
+                break;
+        }
+    }
+    const server = new VideoMCPServer(options);
+    await server.run();
+}
+// 如果直接运行此文件，启动服务器
+if (import.meta.url.endsWith(process.argv[1].replace(/\\/g, '/')) ||
+    process.argv[1].includes('index.js')) {
+    main().catch((error) => {
+        console.error('Server failed to start:', error);
+        process.exit(1);
+    });
+}
+export { VideoMCPServer };