视频编辑器 MCP 服务器

从您最喜欢的 LLM 和 Video Jungle 上传、编辑、搜索和生成视频。

您需要在 Video Jungle 注册一个帐户才能使用此工具，并添加您的 API 密钥。

组件

资源

该服务器实现了一个接口，用于上传、生成和编辑视频，具有以下功能：

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

提示

即将推出。

工具

该服务器实现了一些工具：

• add-video：从 URL 添加视频
  • 返回一个 vj:// URI 来引用视频文件
• search-videos：使用嵌入搜索视频
  • 根据嵌入和关键字返回视频匹配项
• generate-edit-from-videos
  • 从一组视频文件生成渲染的视频编辑
• generate-edit-from-single-video
  • 从单个输入视频文件生成编辑

实践中使用工具

为了使用这些工具，您需要注册 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 的标签搜索 Photos 应用程序中手机上存在的视频。

在我的例子中，当我搜索“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 上的 Photos 应用程序：

$ 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

<details> <details> <summary>已发布的服务器配置</summary>

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

</details> <summary>开发/未发布的服务器配置</summary>

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

启用本地 Photos 应用程序访问（搜索您的 Photos 应用程序）：

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

</details>

请务必将目录替换为您将存储库放置在您的计算机上的目录。

开发

构建和发布

要准备用于分发的软件包：

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 服务器通过 stdio 运行，因此调试可能具有挑战性。为了获得最佳的调试体验，我们强烈建议使用 MCP Inspector。

您可以通过 npm 使用以下命令启动 MCP Inspector：

（请务必将 YOURDIRECTORY 和 YOURAPIKEY 替换为此 repo 所在的目录以及您的 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