MCP Media Processing Server

MCP Media Processing Server

メディア処理操作を実行する Model Context Protocol（MCP）を実装した Node.js サーバーです。強力な動画および画像の操作機能を提供します。

機能

• 動画の処理と変換
• 画像の処理と編集
• メディアの圧縮
• 動画のトリミングと編集
• 画像エフェクトと透かしの追加

前提条件

このサーバーを使用する前に、以下の依存関係がシステムにインストールされていることを確認してください。

• FFmpeg：動画処理操作に必要です

  • macOS：brew install ffmpeg
  • Ubuntu/Debian：sudo apt-get install ffmpeg
  • Windows：FFmpeg の公式ウェブサイトからダウンロードしてください

• ImageMagick：画像処理操作に必要です

  • macOS：brew install imagemagick
  • Ubuntu/Debian：sudo apt-get install imagemagick
  • Windows：ImageMagick の公式ウェブサイトからダウンロードしてください

使用方法

claude_desktop_config.jsonに以下を追加してください。

NPX

{
  "mcpServers": {
    "mediaProcessor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-media-processor@latest"
      ]
    }
  }
}

API

ツール

動画操作

• execute-ffmpeg

  • カスタムオプションを指定して、任意の FFmpeg コマンドを実行します
  • 入力：
    • inputPath（string）：入力動画ファイルの絶対パス
    • options（string[]）：FFmpeg コマンドオプションの配列
    • outputPath（string、任意）：出力ファイルの絶対パス
    • outputFilename（string、任意）：出力ファイル名

• convert-video

  • 動画を別の形式に変換します
  • 入力：
    • inputPath（string）：入力動画ファイルの絶対パス
    • outputFormat（string）：出力形式（例：mp4、mkv、avi）
    • outputPath（string、任意）：カスタム出力パス
    • outputFilename（string、任意）：カスタム出力ファイル名

• compress-video

  • 動画ファイルを圧縮します
  • 入力：
    • inputPath（string）：入力動画ファイルの絶対パス
    • quality（number、任意）：圧縮品質（1～51。数値が小さいほど高品質）
    • outputPath（string、任意）：カスタム出力パス
    • outputFilename（string、任意）：カスタム出力ファイル名

• trim-video

  • 動画を指定した長さにトリミングします
  • 入力：
    • inputPath（string）：入力動画ファイルの絶対パス
    • startTime（string）：HH:MM:SS 形式の開始時刻
    • duration（string）：HH:MM:SS 形式の長さ
    • outputPath（string、任意）：カスタム出力パス
    • outputFilename（string、任意）：カスタム出力ファイル名

画像操作

• compress-image

  • ImageMagick を使用して PNG 画像を圧縮します
  • 入力：
    • inputPath (string)：入力 PNG 画像の絶対パス
    • quality (number, optional)：圧縮品質（1～100）
    • outputPath (string, optional)：カスタム出力パス
    • outputFilename (string, optional)：カスタム出力ファイル名

• convert-image

  • 画像を別の形式に変換します
  • 入力：
    • inputPath (string)：入力画像ファイルの絶対パス
    • outputFormat (string)：希望する出力形式（例：jpg、png、webp、gif）
    • outputPath (string, optional)：カスタム出力パス
    • outputFilename (string, optional)：カスタム出力ファイル名

• resize-image

  • 画像を指定した寸法にリサイズします
  • 入力：
    • inputPath (string)：入力画像ファイルの絶対パス
    • width (number, optional)：目標の幅（ピクセル）
    • height (number, optional)：目標の高さ（ピクセル）
    • maintainAspectRatio (boolean, optional)：アスペクト比を維持するかどうか
    • outputPath (string, optional)：カスタム出力パス
    • outputFilename (string, optional)：カスタム出力ファイル名

• rotate-image

  • 画像を指定した角度で回転します
  • 入力：
    • inputPath (string)：入力画像ファイルの絶対パス
    • degrees (number)：回転角度（度）
    • outputPath (string, optional)：カスタム出力パス
    • outputFilename (string, optional)：カスタム出力ファイル名

• add-watermark

  • 画像にウォーターマークを追加します
  • 入力：
    • inputPath (string)：入力画像ファイルの絶対パス
    • watermarkPath (string)：ウォーターマーク画像ファイルの絶対パス
    • position (string, optional)：ウォーターマークの位置（デフォルト："southeast"）
    • opacity (number, optional)：ウォーターマークの不透明度（0～100）
    • outputPath (string, optional)：カスタム出力パス
    • outputFilename (string, optional)：カスタム出力ファイル名

• apply-effect

  • 画像に視覚効果を適用します
  • 入力：
    • inputPath (string)：入力画像ファイルの絶対パス
    • effect (string)：適用する効果（ぼかし、シャープ化、エッジ、エンボス、グレースケール、セピア、反転）
    • intensity (number, optional)：効果の強度（0～100）
    • outputPath (string, optional)：カスタム出力パス
    • outputFilename (string, optional)：カスタム出力ファイル名

ライセンス

この MCP サーバーは MIT ライセンスのもとでライセンスされています。つまり、MIT ライセンスの利用規約に従うことを条件に、このソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。