Video Editor MCP server
See a demo here: https://www.youtube.com/watch?v=KG6TMLD8GmA
Upload, edit, search, and generate videos from everyone's favorite LLM and Video Jungle.
You'll need to sign up for an account at Video Jungle in order to use this tool, and add your API key.
Components
Resources
The server implements an interface to upload, generate, and edit videos with:
- Custom vj:// URI scheme for accessing individual videos and projects
- Each project resource has a name, description
- Search results are returned with metadata about what is in the video, and when, allowing for edit generation directly
Prompts
Coming soon.
Tools
The server implements a few tools:
- add-video: Add a video from a URL
- search-videos: Search videos using embeddings
- generate-edit-from-videos
- generate-edit-from-single-video
Using Tools in Practice
In order to use the tools, you'll need to sign up for Video Jungle and add your API key.
add-video
Here's an example prompt to invoke the
add-video tool:This will download a video from a URL, add it to your library, and analyze it for retrieval later. Analysis is multi-modal, so both audio and visual components can be queried against.
search-videos
Once you've got a video downloaded and analyzed, you can then do queries on it using the
search-videos tool:Search results contain relevant metadata for generating a video edit according to details discovered in the initial analysis.
search-local-videos
You must set the environment variable
LOAD_PHOTOS_DB=1 in order to use this tool, as it will make Claude prompt to access your files on your local machine.Once that's done, you can search through your Photos app for videos that exist on your phone, using Apple's tags.
In my case, when I search for "Skateboard", I get 1903 video files.
generate-edit-from-videos
Finally, you can use these search results to generate an edit:
(Currently), the video edits tool relies on the context within the current chat.
generate-edit-from-single-video
Finally, you can cut down an edit from a single, existing video:
Configuration
You must login to Video Jungle settings, and get your API key. Then, use this to start Video Jungle MCP:
To allow this MCP server to search your Photos app on MacOS:
Quickstart
Install
Installing via Smithery
To install Video Editor for Claude Desktop automatically via Smithery:
Claude Desktop
You'll need to adjust your
claude_desktop_config.json manually:On MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json With local Photos app access enabled (search your Photos app):
Be sure to replace the directories with the directories you've placed the repository in on your computer.
Development
Building and Publishing
To prepare the package for distribution:
- Sync dependencies and update lockfile:
- Build package distributions:
This will create source and wheel distributions in the
dist/ directory.- Publish to PyPI:
Note: You'll need to set PyPI credentials via environment variables or command flags:
- Token:
--tokenorUV_PUBLISH_TOKEN
- Or username/password:
--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD
Debugging
Since MCP servers run over stdio, debugging can be challenging. For the best debugging
experience, we strongly recommend using the MCP Inspector.
You can launch the MCP Inspector via `npm` with this command:
(Be sure to replace
YOURDIRECTORY and YOURAPIKEY with the directory this repo is in, and your Video Jungle API key, found in the settings page.)Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
Additionally, I've added logging to
app.log in the project directory. You can add logging to diagnose API calls via a:A reasonable way to follow along as you're workin on the project is to open a terminal session and do a:
Video Editor MCP server
See a demo here: https://www.youtube.com/watch?v=KG6TMLD8GmA
Upload, edit, search, and generate videos from everyone's favorite LLM and Video Jungle.
You'll need to sign up for an account at Video Jungle in order to use this tool, and add your API key.
Components
Resources
The server implements an interface to upload, generate, and edit videos with:
- Custom vj:// URI scheme for accessing individual videos and projects
- Each project resource has a name, description
- Search results are returned with metadata about what is in the video, and when, allowing for edit generation directly
Prompts
Coming soon.
Tools
The server implements a few tools:
- add-video: Add a video from a URL
- search-videos: Search videos using embeddings
- generate-edit-from-videos
- generate-edit-from-single-video
Using Tools in Practice
In order to use the tools, you'll need to sign up for Video Jungle and add your API key.
add-video
Here's an example prompt to invoke the
add-video tool:This will download a video from a URL, add it to your library, and analyze it for retrieval later. Analysis is multi-modal, so both audio and visual components can be queried against.
search-videos
Once you've got a video downloaded and analyzed, you can then do queries on it using the
search-videos tool:Search results contain relevant metadata for generating a video edit according to details discovered in the initial analysis.
search-local-videos
You must set the environment variable
LOAD_PHOTOS_DB=1 in order to use this tool, as it will make Claude prompt to access your files on your local machine.Once that's done, you can search through your Photos app for videos that exist on your phone, using Apple's tags.
In my case, when I search for "Skateboard", I get 1903 video files.
generate-edit-from-videos
Finally, you can use these search results to generate an edit:
(Currently), the video edits tool relies on the context within the current chat.
generate-edit-from-single-video
Finally, you can cut down an edit from a single, existing video:
Configuration
You must login to Video Jungle settings, and get your API key. Then, use this to start Video Jungle MCP:
To allow this MCP server to search your Photos app on MacOS:
Quickstart
Install
Installing via Smithery
To install Video Editor for Claude Desktop automatically via Smithery:
Claude Desktop
You'll need to adjust your
claude_desktop_config.json manually:On MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json With local Photos app access enabled (search your Photos app):
Be sure to replace the directories with the directories you've placed the repository in on your computer.
Development
Building and Publishing
To prepare the package for distribution:
- Sync dependencies and update lockfile:
- Build package distributions:
This will create source and wheel distributions in the
dist/ directory.- Publish to PyPI:
Note: You'll need to set PyPI credentials via environment variables or command flags:
- Token:
--tokenorUV_PUBLISH_TOKEN
- Or username/password:
--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD
Debugging
Since MCP servers run over stdio, debugging can be challenging. For the best debugging
experience, we strongly recommend using the MCP Inspector.
You can launch the MCP Inspector via `npm` with this command:
(Be sure to replace
YOURDIRECTORY and YOURAPIKEY with the directory this repo is in, and your Video Jungle API key, found in the settings page.)Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
Additionally, I've added logging to
app.log in the project directory. You can add logging to diagnose API calls via a:A reasonable way to follow along as you're workin on the project is to open a terminal session and do a: