🚀 MCP 服务器 FFmpeg 工具文档

本工具文档涵盖了 MCP 服务器中 FFmpeg 工具的相关内容，介绍了支持的工具列表、工具定义、使用案例、故障排除、开发结构、许可证以及联系方式，能帮助你高效使用和开发相关功能。

🚀 快速开始

本 MCP 服务器 FFmpeg 工具提供了一系列视频和音频处理功能，下面将详细介绍支持的工具列表、工具定义、使用案例、故障排除等内容。

✨ 主要特性

• 创建视频：可将图片序列转换为视频。
• 提取音频：从视频文件中提取音频。
• 剪辑视频：对视频进行剪辑操作。
• 调整视频分辨率：改变视频的分辨率。
• 转换格式：实现不同视频格式的转换。
• 添加水印：为视频添加水印。
• 添加字幕：给视频添加字幕。
• 添加背景音乐：为视频添加背景音乐。
• 合并视频：将多个视频合并为一个。

📦 安装指南

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

💻 使用示例

基础用法

以下是各个工具的基本使用代码示例：

创建视频

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"
})

📚 详细文档

故障排除

视频无法播放

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

音频失真

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

剧毒错误（推测可能是“严重错误”）

• 更新 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