video-editing-mcp

Video Editor MCP 服务器详细介绍

这是一个 Video Editor MCP 服务器项目，旨在将大型语言模型（LLM）的能力与 Video Jungle 服务结合，实现视频的上传、编辑、搜索和生成等一系列功能。通过这个服务器，用户可以使用自然语言指令来管理和操作视频内容。

核心要求

要使用此工具，您必须首先在 Video Jungle 注册一个账号并获取您的API密钥。这是连接和利用 Video Jungle 服务进行视频操作的基础。

功能与组件

1. 服务器接口与资源

   • 服务器提供了上传、生成和编辑视频的接口。
   • 引入了自定义的 vj:// URI 方案，用于唯一标识和便捷地访问单个视频文件和项目资源。
   • 每个项目资源包含名称和描述。
   • 搜索结果会返回关于视频内容、出现时间和位置的详细元数据，这些元数据可以直接用于生成精准的视频编辑。

2. 工具集
   服务器实现了以下几个核心工具，可以通过LLM的指令调用：

   • add-video: 用于从指定的URL（如YouTube链接）添加视频到您的视频库。该工具会下载视频，进行多模态分析（同时分析音频和视觉内容），以便后续检索和查询。成功添加后，会返回一个 vj:// URI 作为该视频文件的引用。
   • search-videos: 利用视频的嵌入（embeddings）和关键词进行搜索。工具会根据查询返回匹配的视频片段及其相关元数据，这些信息对于后续的编辑生成非常有用。
   • generate-edit-from-videos: 根据一组视频文件生成并渲染一个视频编辑。
   • generate-edit-from-single-video: 从单个视频文件生成一个视频编辑。
   • search-local-videos: 这是一个特殊工具，允许搜索您本地设备（例如 MacOS 的“照片”应用）中的视频文件。要启用此功能，您需要设置环境变量 LOAD_PHOTOS_DB=1，这将允许 Claude 提示访问您的本地文件。搜索可以利用 Apple 的标签进行。

实际应用示例

• 添加视频: 您可以使用类似“can you download the video at https://www.youtube.com/shorts/RumgYaH5XYw and name it fly traps?” 这样的指令来调用 add-video 工具。
• 搜索视频: 在视频添加到库并分析完成后，可以使用 search-videos 进行查询，例如：“can you search my videos for fly traps?”。
• 搜索本地视频: 启用本地访问后，可以搜索本地文件，例如：“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”?”（从单个视频生成）。当前的视频编辑工具功能与当前的聊天上下文紧密相关。

配置指南

1. 登录 Video Jungle 设置页面，获取您的API密钥。
2. 使用API密钥启动 Video Editor MCP 服务器：
   $ uv run video-editor-mcp YOURAPIKEY
3. 如需允许 MCP 服务器搜索您 MacOS 上的“照片”应用，请设置环境变量并启动：
   $ LOAD_PHOTOS_DB=1 uv run video-editor-mcp YOURAPIKEY

快速入门

• 通过 Smithery 安装: 可以使用 Smithery 工具自动安装 Video Editor for Claude Desktop：
  npx -y @smithery/cli install video-editor-mcp --client claude
• Claude Desktop 手动配置: 您需要手动编辑 Claude Desktop 的配置文件 claude_desktop_config.json。文件路径在 MacOS 和 Windows 上不同。在 mcpServers 部分添加服务器配置，根据是已发布还是开发版本，以及是否启用本地照片访问，配置命令、参数（包括您的API密钥）和环境变量。请确保将配置文件中的路径占位符替换为您实际存放仓库的目录。

开发相关

• 构建和发布:
  • 同步依赖并更新锁文件：uv sync
  • 构建分发包：uv build (生成的包位于 dist/ 目录)
  • 发布到 PyPI：uv publish (需要通过环境变量或命令行参数设置 PyPI 凭据，如 Token 或用户名/密码)。
• 调试: MCP 服务器通过 stdio 运行，调试可能具有挑战性。强烈推荐使用 MCP Inspector 工具进行调试。可以使用提供的命令（需替换仓库目录和API密钥）启动 MCP Inspector。