FFmpeg Helper

🚀 MCP 服务器 FFmpeg 工具文档

本工具文档涵盖了 MCP 服务器中 FFmpeg 工具的相关内容，包含支持的工具列表、工具定义、实际使用案例、故障排除、开发信息以及许可证等，能帮助你高效使用 FFmpeg 进行视频处理。

🚀 快速开始

本 FFmpeg 工具集提供了丰富的视频处理功能，如创建视频、提取音频等。你可以根据需求选择合适的工具进行使用。

✨ 主要特性

• 支持多种常见的视频处理操作，如创建视频、提取音频、剪辑视频等。
• 提供详细的工具定义和使用示例，方便快速上手。
• 针对可能出现的故障，提供了相应的排除方法。

📦 安装指南

文档未提及安装步骤，故跳过此章节。

💻 使用示例

基础用法

支持的 FFmpeg 工具列表

1. 创建视频
2. 提取音频
3. 剪辑视频
4. 调整视频分辨率
5. 转换格式
6. 添加水印
7. 添加字幕
8. 添加背景音乐
9. 合并视频

工具定义

// 创建视频
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({
  inputPath: "C:/Users/username/videos/song.mp4",
  outputPath: "C:/Users/username/audio/song.mp3",
  format: "mp3"
})

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

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

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

// 添加水印
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({
  inputPath: "C:/Users/username/videos/movie.mp4",
  outputPath: "C:/Users/username/videos/subtitled_movie.mp4",
  subtitlesPath: "C:/Users/username/subs.srt"
})

// 添加背景音乐
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({
  inputPaths: [
    "C:/Users/username/videos/part1.mp4",
    "C:/Users/username/videos/part2.mp4"
  ],
  outputPath: "C:/Users/username/videos/full_video.mp4"
})

高级用法

实际使用案例

// 创建高质量视频
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_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"
})

📚 详细文档

故障排除

1. 视频无法播放

• 检查视频编码是否正确。
• 确保音频和视频流同步。

2. 音频失真

• 检查音频采样率是否匹配。
• 确保音频格式兼容。

3. 剧毒错误（推测为严重错误）

• 更新 FFmpeg 到最新版本。
• 确保所有输入文件完整且无损坏。

开发

项目结构

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

🔧 技术细节

文档未提供足够的技术实现细节，故跳过此章节。

📄 许可证

MIT License

📞 联系方式

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