mcp-ffmpeg

MCP FFmpeg Video Processor

FFmpeg を使用して動画ファイルを操作する Node.js サーバーです。このサーバーは、次の API を提供します。

• 動画をさまざまな解像度（360p、480p、720p、1080p）にリサイズします
• さまざまな形式（MP3、AAC、WAV、OGG）で動画から音声を抽出します

前提条件

このアプリケーションを実行する前に、次のものがインストールされている必要があります。

1. Node.js（v14 以降）
2. FFmpeg - 動画処理に必要です

FFmpeg のインストール

macOS の場合：

brew install ffmpeg

Ubuntu/Debian の場合：

sudo apt update
sudo apt install ffmpeg

Windows の場合：

1. 公式サイトから FFmpeg をダウンロードします
2. ファイルをフォルダー（例：C:\ffmpeg）に展開します
3. bin フォルダーを PATH 環境変数に追加します

インストール

1. このリポジトリをクローンします：

git clone https://github.com/bitscorp-mcp/mcp-ffmpeg.git
cd mcp-ffmpeg

2. 依存関係をインストールします：

npm install

Smithery 経由でのインストール

Smithery 経由で Claude Desktop 用の mcp-ffmpeg を自動的にインストールするには：

npx -y @smithery/cli install @bitscorp-mcp/mcp-ffmpeg --client claude

サーバーの実行

次のコマンドでサーバーを起動します：

npm start

ファイルの変更時に自動再起動する開発モードで実行するには：

npm run dev

Smithery 経由でのインストール

Smithery 経由で Claude Desktop 用の mcp-ffmpeg を自動的にインストールするには：

npx -y @smithery/cli install @bitscorp-mcp/mcp-ffmpeg --client claude

Cursor 用の mcp-ffmpeg をインストールするには、Settings -> Cursor Settings -> Features -> MCP Servers -> + Add に移動します

Type: command を選択し、Adjust の API キーを使用して以下を貼り付けます

npx -y @smithery/cli@latest run @bitscorp/mcp-ffmpeg

Claude Desktop での使用

この MCP FFmpeg サーバーを Claude Desktop と統合すると、自然言語によるリクエストで動画を処理できます。

npx で実行

npx でサーバーを直接実行できます：

npx /path/to/mcp-ffmpeg

または、パッケージを npm に公開している場合：

npx mcp-ffmpeg

Claude Desktop の設定

このサーバーを Claude Desktop に追加するには、Claude Desktop の設定ファイルを更新します。

1. Claude Desktop の設定ファイルを見つけます：

   • macOS：~/.config/claude-desktop/config.json または ~/Library/Application Support/Claude Desktop/config.json
   • Windows：%APPDATA%\Claude Desktop\config.json
   • Linux：~/.config/claude-desktop/config.json

2. mcpServers セクションに FFmpeg MCP サーバーを追加します：

{
    "mcpServers": {
        "ffmpeg": {
            "command": "npx",
            "args": [
                "--yes",
                "/absolute/path/to/mcp-ffmpeg"
            ]
        }
    }
}

パッケージを npm に公開している場合：

{
    "mcpServers": {
        "ffmpeg": {
            "command": "npx",
            "args": [
                "--yes",
                "mcp-ffmpeg"
            ]
        }
    }
}

3. 変更を反映するために Claude Desktop を再起動します。

Claude 用のプロンプト例

設定後、次のようなプロンプトを使用できます。

Using the ffmpeg MCP server, please resize the video at /path/to/video.mp4 to 720p resolution.

注意事項

• アップロードされた動画は一時的に uploads ディレクトリに保存されます
• 処理済みの動画と音声ファイルは output ディレクトリに保存されます
• アップロードできるファイルサイズの上限は 500MB です

ライセンス

MIT