关键词

视频编辑视频生成视频搜索视频图表媒体处理

使用说明

项目简介

Video Editor MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型 (LLM) 提供视频编辑能力。它通过集成 Video Jungle 平台，使得 LLM 客户端能够以标准化的方式访问和操作视频资源，执行视频编辑工具，并利用 Prompt 模板进行定制化的交互。

主要功能点

  • 视频资源管理: 允许 LLM 客户端上传、生成和编辑视频。通过自定义 'vj://' URI 方案访问和管理视频及项目资源。每个项目资源包含名称和描述，方便用户理解和组织视频内容。
  • 视频搜索: 支持通过关键词和嵌入向量搜索 Video Jungle 平台上的视频资源。搜索结果包含视频元数据，例如视频内容描述和时间戳，方便 LLM 精确定位视频片段并生成编辑指令。同时，可选支持搜索本地 Photos app (macOS) 中的视频。
  • 视频编辑工具: 提供一系列工具供 LLM 调用，实现丰富的视频编辑功能：
    • 'add-video': 从 URL 添加视频到 Video Jungle 平台。
    • 'search-videos': 在 Video Jungle 平台上搜索视频。
    • 'search-local-videos': 搜索 macOS Photos app 中的本地视频。
    • 'generate-edit-from-videos': 根据多个视频文件生成视频剪辑。
    • 'generate-edit-from-single-video': 从单个视频文件生成视频剪辑。
    • 'create-video-bar-chart-from-two-axis-data': 根据两轴数据创建条形图视频。
    • 'create-video-line-chart-from-two-axis-data': 根据两轴数据创建折线图视频。
  • Prompt 模板: （即将推出）支持定义和渲染 Prompt 模板，以便 LLM 客户端进行可定制的交互，优化用户体验和任务执行效率。

安装步骤

  1. 安装 Python 包: 使用 pip 安装 'video-editor-mcp' 包： 
    pip install video-editor-mcp
    或者，如果使用 Smithery，可以通过以下命令自动安装并配置 Claude 客户端： 
    npx -y @smithery/cli install video-editor-mcp --client claude
  2. 注册 Video Jungle 账号并获取 API 密钥: 访问 Video Jungle 注册页面 注册账号。登录后，在设置页面获取 API 密钥。该密钥用于服务器连接 Video Jungle 服务。

服务器配置

要将 Video Editor MCP Server 集成到 MCP 客户端（例如 Claude Desktop），需要配置客户端的 MCP 服务器设置。以下是 'claude_desktop_config.json' 文件的配置示例，展示了如何配置 Video Editor MCP Server：

"mcpServers": {
  "video-editor-mcp": {
    "command": "uv",
    "args": [
      "run",
      "video-editor-mcp",
      "<YOUR_VIDEO_JUNGLE_API_KEY>" // 将 <YOUR_VIDEO_JUNGLE_API_KEY> 替换为你的 Video Jungle API 密钥
    ]
  }
}

配置参数说明:

  • 'server name': 'video-editor-mcp' - 服务器名称，在客户端配置中用于标识和引用该服务器。
  • 'command': 'uv' - 指定用于启动服务器的命令。这里 'uv' 是一个 Python 虚拟环境和包管理器，用于运行 Python 脚本。
  • 'args': '["run", "video-editor-mcp", "<YOUR_VIDEO_JUNGLE_API_KEY>"]' - 命令参数列表。
    • '"run"': 'uv' 命令的子命令，用于运行 Python 脚本。
    • '"video-editor-mcp"': 指定要运行的 Python 脚本入口，即 'video_editor_mcp' 包。
    • '"<YOUR_VIDEO_JUNGLE_API_KEY>"': 重要参数 - Video Jungle API 密钥。请务必替换 '<YOUR_VIDEO_JUNGLE_API_KEY>' 为你在 Video Jungle 网站获取的真实 API 密钥。这是服务器连接 Video Jungle 服务所必需的凭证。

启用本地 Photos App 访问 (macOS): 如果需要在 macOS 上启用搜索本地 Photos app 视频的功能，需要在 'env' 字段中设置环境变量 'LOAD_PHOTOS_DB=1'。配置示例如下：

"mcpServers": {
  "video-editor-mcp": {
    "command": "uv",
    "args": [
      "run",
      "video-editor-mcp",
      "<YOUR_VIDEO_JUNGLE_API_KEY>" // 将 <YOUR_VIDEO_JUNGLE_API_KEY> 替换为你的 Video Jungle API 密钥
    ],
    "env": {
      "LOAD_PHOTOS_DB": "1" // 启用本地 Photos app 访问
    }
  }
}

基本使用方法

  1. 确保已完成安装步骤并正确配置 MCP 客户端 (如 Claude Desktop)。
  2. 启动 MCP 客户端，客户端将自动连接到 Video Editor MCP Server。
  3. 在 LLM 客户端中，可以使用自然语言指令来调用服务器提供的工具，例如：
    • 添加视频: 'can you download the video at https://www.youtube.com/shorts/RumgYaH5XYw and name it fly traps?'
    • 搜索 Video Jungle 视频: 'can you search my videos for fly traps?'
    • 搜索本地 Photos App 视频 (macOS): 'can you search my local video files for Skateboard?' (需要先配置 'LOAD_PHOTOS_DB=1')
    • 生成视频剪辑: '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"?'
    • 创建图表视频: 根据数据使用 'create-video-bar-chart-from-two-axis-data' 或 'create-video-line-chart-from-two-axis-data' 工具生成条形图或折线图视频。

通过上述指令，LLM 客户端将调用 Video Editor MCP Server 提供的工具，实现视频的上传、搜索、编辑和生成等功能。

信息

分类

AI与计算

访问项目