Ffmpeg Helper

🚀 MCP Server FFmpeg Tools Documentation

This documentation provides a comprehensive guide to the FFmpeg tools supported by the MCP server, including tool definitions, usage examples, troubleshooting tips, and development information.

✨ Features

Supported FFmpeg Tools List

1. Create Video
2. Extract Audio
3. Trim Video
4. Adjust Video Resolution
5. Convert Format
6. Add Watermark
7. Add Subtitles
8. Add Background Music
9. Merge Videos

📦 Installation

No installation steps are provided in the original document, so this section is skipped.

💻 Usage Examples

Basic Usage

Create Video

create_video({
  inputPattern: "C:/Users/username/images/bear/%05d.jpg",
  outputPath: "C:/Users/username/videos/bear.mp4",
  framerate: 30,
  codec: "libx264",
  pixelFormat: "yuv420p"
})

Extract Audio

extract_audio({
  inputPath: "C:/Users/username/videos/song.mp4",
  outputPath: "C:/Users/username/audio/song.mp3",
  format: "mp3"
})

Trim Video

trim_video({
  inputPath: "C:/Users/username/videos/long_video.mp4",
  outputPath: "C:/Users/username/videos/clip.mp4",
  startTime: "0",
  duration: "10"
})

Adjust Resolution

adjust_resolution({
  inputPath: "C:/Users/username/videos/high_res.mp4",
  outputPath: "C:/Users/username/videos/low_res.mp4",
  width: 800,
  height: 600
})

Convert Format

convert_format({
  inputPath: "C:/Users/username/videos/source.mov",
  outputPath: "C:/Users/username/videos/output.mp4",
  format: "mp4"
})

Add Watermark

add_watermark({
  inputPath: "C:/Users/username/videos/unwatermarked.mp4",
  outputPath: "C:/Users/username/videos/watermarked.mp4",
  watermarkPath: "C:/Users/username/logo.png",
  position: { x: 10, y: 10 }
})

Add Subtitles

add_subtitles({
  inputPath: "C:/Users/username/videos/movie.mp4",
  outputPath: "C:/Users/username/videos/subtitled_movie.mp4",
  subtitlesPath: "C:/Users/username/subs.srt"
})

Add Background Music

add_background_music({
  inputVideoPath: "C:/Users/username/videos/original.mp4",
  outputVideoPath: "C:/Users/username/videos/final.mp4",
  musicPath: "C:/Users/username/music/background.mp3"
})

Merge Videos

merge_videos({
  inputPaths: [
    "C:/Users/username/videos/part1.mp4",
    "C:/Users/username/videos/part2.mp4"
  ],
  outputPath: "C:/Users/username/videos/full_video.mp4"
})

Advanced Usage

Create High-Quality Video

create_video({
  inputPattern: "C:/Users/username/images/bear/%05d.jpg",
  outputPath: "C:/Users/username/videos/bear_high.mp4",
  framerate: 60,
  codec: "libx265",
  pixelFormat: "yuv420p"
})

Trim and Add Background Music

trim_video({
  inputPath: "C:/Users/username/videos/original.mp4",
  outputPath: "C:/Users/username/videos/clipped.mp4",
  startTime: "5",
  duration: "10"
});

add_background_music({
  inputVideoPath: "C:/Users/username/videos/clipped.mp4",
  outputVideoPath: "C:/Users/username/videos/final_clip.mp4",
  musicPath: "C:/Users/username/music/background.mp3"
})

📚 Documentation

Troubleshooting

Video Cannot Be Played

• Check if the video encoding is correct.
• Ensure that the audio and video streams are synchronized.

Audio Distortion

• Check if the audio sampling rate matches.
• Ensure that the audio format is compatible.

Severe Errors

• Update FFmpeg to the latest version.
• Ensure that all input files are complete and undamaged.

Development

Project Structure

mcp-server-ffmpeg/
├── src/
│   ├── main.js
│   └── ffmpeg_utils.js
└── bin/
    └── mcp-ffmpeg

📄 License

MIT License

Contact Information

• Email: support@mcp-server.com
• GitHub: https://github.com/mcp-server/ffmpeg-tools