hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Provides access to videos stored in the macOS Photos app when enabled with the LOAD_PHOTOS_DB environment variable
Allows downloading videos from YouTube URLs to add to the user's video library

ビデオエディターMCPサーバー

デモはこちらをご覧ください: https://www.youtube.com/watch?v=KG6TMLD8GmA

みんなのお気に入りの LLM とVideo Jungleからビデオをアップロード、編集、検索、生成します。

このツールを使用するには、 Video Jungleでアカウントを登録し、API キーを追加する必要があります。

コンポーネント

リソース

サーバーは、次の機能を使用してビデオをアップロード、生成、編集するためのインターフェースを実装します。

個々のビデオやプロジェクトにアクセスするためのカスタム vj:// URI スキーム
各プロジェクトリソースには名前と説明があります
検索結果には、動画の内容と日時に関するメタデータが返され、直接編集を生成できます。

プロンプト

近日公開。

ツール

サーバーはいくつかのツールを実装します:

add-video: URLからビデオを追加する
- ビデオファイルを参照するための vj:// URI を返します
search-videos: 埋め込みを使用してビデオを検索する
- 埋め込みとキーワードに基づいてビデオの一致を返します
動画から生成・編集
- 一連のビデオファイルからレンダリングされたビデオ編集を生成します
単一のビデオから生成・編集
- 単一の入力ビデオファイルから編集を生成する

ツールの実践的な使用

ツールを使用するには、Video Jungle にサインアップして API キーを追加する必要があります。

ビデオを追加

以下は、 add-videoツールを呼び出すためのプロンプトの例です。

can you download the video at https://www.youtube.com/shorts/RumgYaH5XYw and name it fly traps?

URLから動画をダウンロードし、ライブラリに追加して分析し、後で取り出すことができます。分析はマルチモーダルなので、音声と映像の両方の要素をクエリできます。

検索動画

ビデオをダウンロードして分析したら、 search-videosツールを使用してビデオに対するクエリを実行できます。

can you search my videos for fly traps?

検索結果には、初期分析で発見された詳細に従ってビデオ編集を生成するための関連メタデータが含まれます。

ローカル動画を検索

このツールを使用するには、環境変数LOAD_PHOTOS_DB=1を設定する必要があります。これにより、Claude はローカルマシン上のファイルにアクセスするように要求します。

それが完了すると、Apple のタグを使用して、携帯電話にあるビデオを写真アプリで検索できるようになります。

私の場合、「スケートボード」を検索すると、1903 個のビデオファイルが見つかります。

can you search my local video files for Skateboard?

動画から生成・編集

最後に、これらの検索結果を使用して編集を生成できます。

can you create an edit of all the times the video says "fly trap"?

(現在) ビデオ編集ツールは、現在のチャット内のコンテキストに依存しています。

単一のビデオから生成・編集

最後に、既存の単一のビデオから編集を削減できます。

can you create an edit of all the times this video says the word "fly trap"?

構成

Video Jungleの設定にログインし、 APIキーを取得してください。その後、これを使用してVideo Jungle MCPを起動してください。

$ uv run video-editor-mcp YOURAPIKEY

この MCP サーバーが MacOS 上のフォトアプリを検索できるようにするには:

$ LOAD_PHOTOS_DB=1 uv run video-editor-mcp YOURAPIKEY

クイックスタート

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用のビデオエディターを自動的にインストールするには:

npx -y @smithery/cli install video-editor-mcp --client claude

クロードデスクトップ

claude_desktop_config.json手動で調整する必要があります。

MacOS の場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

 "mcpServers": {
   "video-editor-mcp": {
     "command": "uvx",
     "args": [
       "video-editor-mcp",
       "YOURAPIKEY"
     ]
   }
 }

 "mcpServers": {
   "video-editor-mcp": {
     "command": "uv",
     "args": [
       "--directory",
       "/Users/YOURDIRECTORY/video-editor-mcp",
       "run",
       "video-editor-mcp",
       "YOURAPIKEY"
     ]
   }
 }

ローカルフォトアプリのアクセスが有効になっている場合（フォトアプリを検索）：

  "video-jungle-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/<PATH_TO>/video-jungle-mcp",
      "run",
      "video-editor-mcp",
      "<YOURAPIKEY>"
    ],
   "env": {
        "LOAD_PHOTOS_DB": "1"
    }
  },

ディレクトリを、コンピューター上にリポジトリを配置したディレクトリに置き換えてください。

発達

建築と出版

配布用のパッケージを準備するには:

依存関係を同期し、ロックファイルを更新します。

uv sync

パッケージディストリビューションをビルドします。

uv build

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

PyPI に公開:

uv publish

注: 環境変数またはコマンドフラグを使用して PyPI 資格情報を設定する必要があります。

トークン: --tokenまたはUV_PUBLISH_TOKEN
またはユーザー名/パスワード: --username / UV_PUBLISH_USERNAMEおよび--password / UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。

次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。

( YOURDIRECTORYとYOURAPIKEY 、このリポジトリがあるディレクトリと、設定ページにある Video Jungle API キーに置き換えてください。)

npx @modelcontextprotocol/inspector uv run --directory /Users/YOURDIRECTORY/video-editor-mcp video-editor-mcp YOURAPIKEY

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。

さらに、プロジェクトディレクトリのapp.logにログ記録を追加しました。以下のコマンドでAPI呼び出しを診断するためのログ記録を追加できます。

logging.info("this is a test log")

プロジェクトの作業を追跡する適切な方法は、ターミナルセッションを開いて次の操作を実行することです。

$ tail -n 90 -f app.log

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

みんなのお気に入りの LLM とVideo Jungleからビデオをアップロード、編集、生成します。

video-editing-mcp