Video Editing MCP

视频编辑器MCP服务器


请点击此处观看演示： https://www.youtube.com/watch?v=KG6TMLD8GmA

从每个人最喜欢的LLM和LLM上传、编辑、搜索和生成视频 视频丛林.

您需要在以下网址注册一个帐户 视频丛林 以便使用此工具，并添加您的API密钥。

](https://badge.fury.io/py/video-editor-mcp)

组件

资源

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

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

鼓励

马上就来。

工具

服务器实现了一些工具：

• 添加视频

- 从URL添加视频文件进行分析。返回vj://URI以引用视频文件

• 创建视频丛林项目

- 创建一个Video Jungle项目，其中包含生成脚本、分析的视频和用于视频编辑生成的图像

• 本地编辑

- 创建OpenTimelineIO项目并将其下载到您的计算机上，以便在Davinci Resolve Studio实例中打开（Resolve Studio _必须_ 在调用此工具之前，它已经在运行。)

• 从视频生成编辑

- 从一组视频文件生成渲染视频编辑

• 从单个视频生成编辑

- 从单个输入视频文件生成编辑

• 获取项目资产

- 获取项目中的资源以生成视频编辑。

• 搜索视频

- 根据嵌入和关键字返回视频匹配

• 更新视频编辑

- 实时更新视频编辑信息。如果Video Jungle处于打开状态，则编辑将实时更新。

在实践中使用工具

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

添加视频

下面是一个调用 add-video 工具：

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

这将从URL下载视频，将其添加到您的库中，并对其进行分析以供以后检索。分析是多模态的，因此可以查询音频和视觉组件。

搜索视频

下载并分析视频后，您可以使用 search-videos 工具：

can you search my videos for fly traps?

搜索结果包含相关元数据，用于根据初始分析中发现的细节生成视频编辑。

搜索本地视频

您必须设置环境变量 LOAD_PHOTOS_DB=1 为了使用此工具，因为它将使Claude提示您访问本地计算机上的文件。

完成后，您可以使用Apple的标签在“照片”应用程序中搜索手机上存在的视频。

就我而言，当我搜索“滑板”时，我得到1903个视频文件。

can you search my local video files for Skateboard?

从视频生成编辑

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

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

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

从单个视频生成编辑

最后，您可以从单个现有视频中删除编辑：

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

配置

您必须登录 视频丛林设置，并得到你的 API密钥。然后，使用此命令启动Video Jungle MCP：

$ uv run video-editor-mcp YOURAPIKEY

要允许此MCP服务器在MacOS上搜索您的照片应用程序：

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

快速启动

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面视频编辑器 史密瑟里:

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

克劳德桌面

你需要调整你的 claude_desktop_config.json 手动：

在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%/Claude/claude_desktop_config.json

Published Server Configuration

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

Development/Unpublished Servers Configuration

 "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/
/video-jungle-mcp",
      "run",
      "video-editor-mcp",
      ""
    ],
   "env": {
        "LOAD_PHOTOS_DB": "1"
    }
  },

一定要用您放置存储库的目录替换这些目录 你的 电脑。

发展

建筑与出版

准备分发包裹：

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

uv sync

1. 构建包分发：

uv build

这将在 dist/ 目录。

1. 发布到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检查员.

您可以通过以下方式启动MCP检查器 使用此命令：

（一定要更换 YOURDIRECTORY 和 YOURAPIKEY 使用此repo所在的目录，以及在设置页面中找到的Video Jungle API密钥。)

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

启动后，检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。

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

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

在项目工作中，一个合理的方法是打开一个终端会话并执行以下操作：

$ tail -n 90 -f app.log