MCP FFmpeg Helper

Instructions

Implementation Reference

• src/tools/handlers.ts:11-20 (handler)

  Handler logic for 'get_video_info' tool: validates the filePath argument and delegates to getVideoInfo helper function, returning the info as text content.

  case "get_video_info": {
    const filePath = validatePath(String(args?.filePath), true);
    const info = await getVideoInfo(filePath);
    return {
      content: [{
        type: "text",
        text: info
      }]
    };
  }

• src/utils/ffmpeg.ts:27-40 (helper)

  Core implementation: uses ffprobe to extract detailed video information (format and streams) in JSON format, with path validation and error handling.

  export async function getVideoInfo(filePath: string): Promise<string> {
    try {
      validatePath(filePath, true);
      console.log(`Getting video info for: ${filePath}`);
      const { stdout, stderr } = await execPromise(`ffprobe -v error -show_format -show_streams -print_format json "${filePath}"`);
      return stdout || stderr;
    } catch (error: any) {
      console.error("FFprobe error:", error.message);
      if (error.stderr) {
        return error.stderr;
      }
      throw new Error(`FFprobe error: ${error.message}`);
    }
  }

• src/tools/definitions.ts:6-19 (schema)

  Tool schema definition: specifies name, description, and input schema requiring a 'filePath' string.

  {
    name: "get_video_info",
    description: "Get detailed information about a video file",
    inputSchema: {
      type: "object",
      properties: {
        filePath: {
          type: "string",
          description: "Path to the video file"
        }
      },
      required: ["filePath"]
    }
  },

• src/index.ts:46-50 (registration)

  Registers all tools including 'get_video_info' by exposing toolDefinitions in the ListToolsRequest handler.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return {
      tools: toolDefinitions
    };
  });

• src/index.ts:56-68 (registration)

  Registers the CallToolRequest handler which dispatches to handleToolCall based on tool name, enabling execution of 'get_video_info'.

  server.setRequestHandler(CallToolRequestSchema, async (request) => {
    try {
      return await handleToolCall(request.params.name, request.params.arguments);
    } catch (error: any) {
      console.error("Tool execution error:", error.message);
      return {
        content: [{
          type: "text",
          text: `Error: ${error.message}`
        }]
      };
    }
  });