Video Editor MCP server

视频编辑器 MCP 服务

在此查看演示：https://www.youtube.com/watch?v=KG6TMLD8GmA

通过大家喜爱的大模型和 Video Jungle，上传、编辑、搜索和生成视频。

你需要在 Video Jungle 注册账号才能使用此工具，并添加你的 API 密钥。

组件

资源

此服务实现了一个用于上传、生成和编辑视频的接口，支持：

• 用于访问单个视频和项目的自定义 vj:// URI 方案
• 每个项目资源都包含名称和描述
• 搜索结果会返回视频内容及对应时间点的元数据，可直接用于生成剪辑

提示词

即将推出。

工具

此服务实现了若干工具：

• add-video
  • 从 URL 添加视频文件进行分析。返回一个 vj:// URI，用于引用该视频文件
• create-videojungle-project
  • 创建一个 Video Jungle 项目，用于存放生成脚本、已分析的视频和图像，以生成视频剪辑
• edit-locally
  • 创建 OpenTimelineIO 项目并下载到你的设备，以便在 Davinci Resolve Studio 实例中打开（调用此工具前，Resolve Studio 必须 已在运行。）
• generate-edit-from-videos
  • 根据一组视频文件生成渲染后的视频剪辑
• generate-edit-from-single-video
  • 根据单个输入视频文件生成剪辑
• get-project-assets
  • 获取项目中用于生成视频剪辑的资源。
• search-videos
  • 根据嵌入向量和关键词返回匹配的视频
• update-video-edit
  • 实时更新视频剪辑的信息。如果 Video Jungle 已打开，剪辑将实时更新。

实际使用工具

要使用这些工具，你需要注册 Video Jungle 并添加 API 密钥。

add-video

以下是调用 add-video 工具的提示词示例：

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

此操作会从 URL 下载视频，将其添加到你的媒体库，并进行分析，以供之后检索。分析采用多模态方式，因此可以查询音频和视觉内容。

search-videos

下载并分析视频后，你就可以使用 search-videos 工具查询视频：

can you search my videos for fly traps?

搜索结果包含相关元数据，可根据初步分析中发现的详情生成视频剪辑。

search-local-videos

你必须设置环境变量 LOAD_PHOTOS_DB=1 才能使用此工具，因为这会使 Claude 提示你授权访问本地设备上的文件。

设置完成后，你可以使用 Apple 的标签在“照片”应用中搜索手机上的视频。

例如，我搜索“Skateboard”时，找到了 1903 个视频文件。

can you search my local video files for Skateboard?

generate-edit-from-videos

最后，你可以使用这些搜索结果生成剪辑：

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

（目前）视频剪辑工具依赖当前聊天中的上下文。

generate-edit-from-single-video

最后，你可以从单个现有视频中截取并制作剪辑：

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 安装 Video Editor：

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

Claude Desktop

你需要手动调整 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"
    }
  },

请务必将目录替换为你自己的电脑上存放此代码库的目录。

开发

构建和发布

准备分发软件包：

1. 同步依赖项并更新锁文件：

uv sync

2. 构建软件包分发文件：

uv build

这将在 dist/ 目录中创建源代码分发包和 wheel 分发包。

3. 发布到 PyPI：

uv publish

注意：你需要通过环境变量或命令标志设置 PyPI 凭据：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或用户名／密码：--username／UV_PUBLISH_USERNAME 和 --password／UV_PUBLISH_PASSWORD

MCP 服务注册表

mcp-name: io.github.burningion/video-editing-mcp

调试

由于 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

启动后，Inspector 会显示一个 URL，你可以在浏览器中访问该 URL 开始调试。

此外，我已在项目目录中的 app.log 添加了日志记录。你可以通过以下方式添加日志来诊断 API 调用：

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

在项目开发过程中，打开终端会话并执行以下命令，是一种不错的跟进方式：

$ tail -n 90 -f app.log