MCP HubMCP Hub
burningion

video-editing-mcp

by: burningion

MCP Interface for Video Jungle

105created 03/12/2024
Visit
Video
Interface

📌Overview

Purpose: To provide a versatile server for uploading, editing, and generating videos seamlessly using the Video Jungle platform.

Overview: The Video Editor MCP server allows users to upload, edit, and manage videos through an intuitive interface. By integrating with the Video Jungle API, it enables powerful video generation and retrieval capabilities, enhancing users' content creation experience.

Key Features:

  • Video Uploading and Reference: The add-video tool allows users to import videos from URLs and returns a custom vj:// URI for easy referencing and management of video assets.

  • Intelligent Video Search: The search-videos tool provides advanced search capabilities by leveraging embeddings, allowing users to find relevant videos based on audio-visual content and descriptive keywords.

  • Automated Video Editing: With tools like generate-edit-from-videos and generate-edit-from-single-video, users can create tailored video edits by specifying desired criteria, streamlining content creation for targeted messaging.


Video Editor MCP Server

Upload, edit, search, and generate videos with Video Jungle.

Components

Resources

  • Custom vj:// URI scheme for accessing individual videos and projects
  • Each project has a name and description
  • Search results include metadata to facilitate video editing

Tools

The server includes several tools:

  • add-video: Add a video from a URL and receive a vj:// URI for reference.
  • search-videos: Search videos using embeddings and keywords.
  • generate-edit-from-videos: Create a rendered edit from multiple video files.
  • generate-edit-from-single-video: Create an edit from a single video file.

Using Tools

  1. add-video Example:

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

    can you search my videos for fly traps?
    
  3. search-local-videos: Set LOAD_PHOTOS_DB=1 to access local video files.

  4. generate-edit-from-videos Example:

    can you create an edit of all the times the video says "fly trap"?
    
  5. generate-edit-from-single-video Example:

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

Configuration

  1. Obtain your API key from Video Jungle settings.
  2. Start Video Jungle MCP:
    $ uv run video-editor-mcp YOURAPIKEY
    

To enable local Photos app access on MacOS:

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

Quickstart

Installation

Via Smithery

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

Configuration

Adjust your claude_desktop_config.json as needed.

Example Configuration for Published Server:

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

Development

Building and Publishing

  1. Sync dependencies:
    uv sync
    
  2. Build package:
    uv build
    
  3. Publish to PyPI:
    uv publish
    

Debugging

For debugging, use the MCP Inspector:

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

Logs can be monitored using:

$ tail -n 90 -f app.log