FFmpeg Helper

内容官方认证本地 TypeScript

🚀 MCP 服务器 FFmpeg 工具文档

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

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

💻 使用示例

基础用法

支持的 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"
})

📚 详细文档

故障排除

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

0 条评论
分类：内容