Ffmpeg Helper

🚀 MCP サーバー FFmpeg ツールドキュメント

このドキュメントでは、MCP サーバー用の FFmpeg ツールについて説明します。これらのツールを使用することで、ビデオの作成、編集、変換などの操作を行うことができます。

✨ 主な機能

• ビデオ作成：画像からビデオを作成します。
• オーディオ抽出：ビデオからオーディオを抽出します。
• ビデオクリッピング：ビデオを指定した区間でクリップします。
• 解像度調整：ビデオの解像度を調整します。
• 形式変換：ビデオの形式を変換します。
• ウォーターマーク追加：ビデオにウォーターマークを追加します。
• 字幕追加：ビデオに字幕を追加します。
• バックグラウンドミュージック追加：ビデオにバックグラウンドミュージックを追加します。
• ビデオ結合：複数のビデオを結合します。

📦 インストール

ドキュメントにインストール手順が記載されていないため、このセクションは省略します。

💻 使用例

基本的な使用法

1. ビデオ作成

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

2. オーディオ抽出

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

3. ビデオクリッピング

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

4. 解像度調整

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

5. 形式変換

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

6. ウォーターマーク追加

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

7. 字幕追加

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

8. バックグラウンドミュージック追加

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

9. ビデオ結合

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