Ffmpeg MCP Lite

🚀 ffmpeg-mcp

FFmpegを通じた強力なビデオとオーディオ処理用のMCPサーバーです。FFmpegをClaude、DiveなどのMCP互換AIシステムと統合し、自然言語でビデオの変換、圧縮、トリミング、オーディオ抽出などを行うことができます。

✨ 主な機能

🚀 クイックスタート

前提条件

システムにFFmpegをインストールします。

開始方法

MCPクライアントに以下の設定を追加します。

{
  "mcpServers": {
    "ffmpeg": {
      "command": "uvx",
      "args": ["ffmpeg-mcp-lite"]
    }
  }
}

MCPクライアントの設定

claude mcp add ffmpeg uvx ffmpeg-mcp-lite

{
  "mcpServers": {
    "ffmpeg": {
      "command": "uvx",
      "args": ["ffmpeg-mcp-lite"]
    }
  }
}

code --add-mcp '{"name":"ffmpeg","command":"uvx","args":["ffmpeg-mcp-lite"]}'

手動インストール

pip install ffmpeg-mcp-lite

またはuvを使用する場合:

uv pip install ffmpeg-mcp-lite

🛠️ 利用可能なツール

すべてのツールは、他のMCPサーバーとの名前の衝突を避けるためにffmpeg_で始まります。

📊 メディア情報

🔄 変換と圧縮

✂️ 編集

🎵 オーディオとフレーム

📝 字幕

💻 使用例

メディア情報の取得

"/path/to/video.mp4に関する情報を取得"
"このビデオの解像度と再生時間は何ですか？"
"私のビデオのコーデック情報を表示してください"

ビデオの変換

"video.mp4をWebM形式に変換"
"このビデオをh265コーデックでMKVに変換"
"変換して1280x720にスケーリング"

ビデオの圧縮

"video.mp4を中品質で圧縮"
"このビデオのファイルサイズを削減するために圧縮し、高速プリセットを使用"
"高品質で圧縮して1920:-1にスケーリング"

ビデオのトリミング

"video.mp4を00:01:00から00:02:30までトリミング"
"このビデオの最初の30秒をカット"
"5:00から始まる1分間のクリップを抽出"

オーディオの抽出

"video.mp4からMP3としてオーディオを抽出"
"192kビットレートのAAC形式でオーディオトラックを取得"
"最高品質のFLACとしてオーディオを抽出"

フレームの抽出

"video.mp4から5秒ごとに1フレームを抽出"
"このビデオから均等に10フレームを取得"
"フレームをPNG画像として抽出"

ビデオの結合

"video1.mp4とvideo2.mp4を結合"
"この3つのビデオを1つに結合"

字幕の追加

"video.mp4にsubtitles.srtを追加"
"影付きのスタイルで中国語の字幕を埋め込む"
"フォントサイズ32でグローエフェクトの字幕を追加"

🔧 設定

環境変数

カスタム設定

{
  "mcpServers": {
    "ffmpeg": {
      "command": "uvx",
      "args": ["ffmpeg-mcp-lite"],
      "env": {
        "FFMPEG_OUTPUT_DIR": "/path/to/output"
      }
    }
  }
}

🏗️ アーキテクチャ

構築に使用された技術

• FFmpeg - ビデオ/オーディオ処理エンジン
• FastMCP - MCP Pythonフレームワーク
• asyncio - 非同期サブプロセス実行
• Python 3.10+ - 型ヒントと最新の機能

主要な特徴

• ✅ 非同期処理: 非ブロッキングなFFmpeg実行
• ✅ 型安全: mypyによる完全な型ヒントの検証
• ✅ 十分にテスト済み: pytestによる31のテストケース
• ✅ クロスプラットフォーム: Windows、macOS、Linuxで動作
• ✅ モジュール設計: ツールごとに1つのファイル

🤝 コントリビュート

コントリビューションは大歓迎です！

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを作成します。

開発

# クローンしてインストール
git clone https://github.com/kevinwatt/ffmpeg-mcp-lite.git
cd ffmpeg-mcp-lite
uv sync

# テストを実行
uv run pytest

# 型チェック
uv run mypy src/

# リンティング
uv run ruff check src/

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

• FFmpeg - 強力なマルチメディアフレームワーク
• Anthropic - モデルコンテキストプロトコルの提供
• Dive - MCP互換のAIプラットフォーム