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

Servidor MCP del editor de vídeo

Vea una demostración aquí: https://www.youtube.com/watch?v=KG6TMLD8GmA

Sube, edita, busca y genera vídeos desde los LLM y Video Jungle favoritos de todos.

Necesitará registrarse para obtener una cuenta en Video Jungle para poder utilizar esta herramienta y agregar su clave API.

Componentes

Recursos

El servidor implementa una interfaz para cargar, generar y editar videos con:

Esquema de URI vj:// personalizado para acceder a videos y proyectos individuales
Cada recurso del proyecto tiene un nombre y una descripción.
Los resultados de la búsqueda se devuelven con metadatos sobre qué hay en el video y cuándo, lo que permite la generación de ediciones directamente.

Indicaciones

Muy pronto.

Herramientas

El servidor implementa algunas herramientas:

add-video: Agregar un video desde una URL
- Devuelve un URI vj:// para hacer referencia al archivo de vídeo
search-videos: busca vídeos mediante incrustaciones
- Devuelve coincidencias de vídeo basadas en incrustaciones y palabras clave
generar-editar-a-partir-de-videos
- Genera una edición de video renderizada a partir de un conjunto de archivos de video.
generar-edición-a-partir-de-un-solo-video
- Generar una edición a partir de un único archivo de vídeo de entrada

Uso de herramientas en la práctica

Para utilizar las herramientas, deberá registrarse en Video Jungle y agregar su clave API.

añadir vídeo

A continuación se muestra un ejemplo de solicitud para invocar la herramienta add-video :

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

Esto descargará un video de una URL, lo añadirá a tu biblioteca y lo analizará para recuperarlo más tarde. El análisis es multimodal, por lo que se pueden consultar tanto los componentes de audio como los visuales.

búsqueda de vídeos

Una vez que hayas descargado y analizado un video, podrás realizar consultas sobre él utilizando la herramienta search-videos :

can you search my videos for fly traps?

Los resultados de la búsqueda contienen metadatos relevantes para generar una edición de video según los detalles descubiertos en el análisis inicial.

buscar videos locales

Debe configurar la variable de entorno LOAD_PHOTOS_DB=1 para poder usar esta herramienta, ya que hará que Claude le solicite acceder a sus archivos en su máquina local.

Una vez hecho esto, puedes buscar a través de tu aplicación Fotos los videos que existen en tu teléfono, usando las etiquetas de Apple.

En mi caso, cuando busco "Skateboard" obtengo 1903 archivos de vídeo.

can you search my local video files for Skateboard?

generar-editar-a-partir-de-videos

Finalmente, puedes utilizar estos resultados de búsqueda para generar una edición:

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

(Actualmente), la herramienta de edición de video depende del contexto dentro del chat actual.

generar-edición-a-partir-de-un-solo-video

Finalmente, puedes cortar una edición de un solo vídeo existente:

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

Configuración

Debes iniciar sesión en la configuración de Video Jungle y obtener tu clave API . Úsala para iniciar Video Jungle MCP:

$ uv run video-editor-mcp YOURAPIKEY

Para permitir que este servidor MCP busque su aplicación Fotos en MacOS:

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

Inicio rápido

Instalar

Instalación mediante herrería

Para instalar Video Editor para Claude Desktop automáticamente a través de Smithery :

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

Escritorio de Claude

Necesitarás ajustar tu claude_desktop_config.json manualmente:

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json En 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"
     ]
   }
 }

Con el acceso a la aplicación Fotos local habilitado (busque su aplicación Fotos):

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

Asegúrese de reemplazar los directorios con los directorios en los que ha colocado el repositorio en su computadora.

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

Distribuciones de paquetes de compilación:

uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

Publicar en PyPI:

uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

Token: --token o UV_PUBLISH_TOKEN
O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

(Asegúrese de reemplazar YOURDIRECTORY y YOURAPIKEY con el directorio en el que se encuentra este repositorio y su clave API de Video Jungle, que se encuentra en la página de configuración).

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

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

Además, he añadido el registro a app.log en el directorio del proyecto. Puedes añadir el registro para diagnosticar las llamadas a la API mediante:

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

Una forma razonable de seguir mientras trabajas en el proyecto es abrir una sesión de terminal y hacer lo siguiente:

$ tail -n 90 -f app.log

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Sube, edita y genera vídeos desde los LLM y Video Jungle favoritos de todos.

video-editing-mcp