@velxor/mcp

一个 MCP（模型上下文协议）服务器，让 Claude Code、Cursor 及其他支持 MCP 的智能体能够直接在编码会话中驱动 Vlexor 的三大支柱——AI 视频编辑、游戏资产生成和动态图形制作。

视频编辑基于您自己的素材运行：您的原始视频永远不会离开您的机器——只有您的指令文本（以及可选的转录文本）会被发送到 Vlexor 以生成编辑方案，该方案会被编译为真实的 FFmpeg 命令并完全在本地渲染。资产生成和动态图形则在服务器端渲染（因为没有需要保护的本地素材），并返回一个带签名的下载 URL——可选择直接保存到本地路径。

设置

1. 在 Vlexor → 设置 → MCP 与 API 生成个人 API 密钥。

2. 如果尚未安装 FFmpeg，请先安装（macOS 上使用 brew install ffmpeg，或将 VLEXOR_FFMPEG_DIR 指向包含 ffmpeg/ffprobe 的文件夹）。

3. 将以下内容添加到 MCP 客户端的配置中：

{
  "mcpServers": {
    "vlexor": {
      "command": "npx",
      "args": ["-y", "@velxor/mcp"],
      "env": { "VLEXOR_API_KEY": "vlx_…" }
    }
  }
}

Related MCP server: CutPilot

工具

支柱 1 — 视频编辑（本地渲染；素材不上传）：

• probe_media — 读取本地视频的时长、分辨率、帧率、编码格式。

• generate_edit_plan — 自然语言指令 → 结构化编辑方案（调用真实的 Vlexor 命令引擎；计入您的套餐使用量）。

• compile_edit_plan — 编辑方案 → 真实的 FFmpeg 命令，完全在本地计算。

• render — 在本地运行编译后的命令以生成最终视频。

典型的智能体流程：probe_media → generate_edit_plan →（审查步骤）→ compile_edit_plan →（审查 FFmpeg 命令）→ render。

支柱 2 — 资产生成（服务器端渲染）：

• generate_game_asset — 提示词 → 纹理、2D 角色、精灵表、3D 模型（.glb）、音效、音乐曲目、视差背景或角色转面图。返回带签名的下载 URL；传入 savePath 可同时将文件写入本地。

支柱 3 — 动态图形（服务器端渲染）：

• generate_motion_graphic — 简短的创意简报 → 渲染后的动态标题 .mp4（公告/宣传卡片）。返回带签名的下载 URL；传入 savePath 可同时将文件写入本地。

环境变量

关于此仓库

此包是连接 MCP 客户端与 Vlexor 真实托管 API 的轻量集成层——此处的每个工具调用都是一个普通、可检查的 HTTP 请求（您可以在 src/api-client.ts 中准确查看哪些数据离开了您的机器）。它是开放的，以便通过它传递 API 密钥的智能体开发者能够自行验证。

Vlexor 平台本身——编辑引擎、AI 提示设计、资产/动态图形生成管道——是闭源的。此包中的一些导入（@velxor/engine 的 FFmpeg 方案编译器、@velxor/shared 的类型定义）来自该私有代码库，并未单独发布，因此此仓库无法独立运行 pnpm install/构建——它仅供阅读，并通过预构建的 npm 包（npx -y @velxor/mcp）运行，而非从此检出编译。

欢迎提交关于 MCP 集成层本身（工具模式、错误处理、本地 FFmpeg 编排）的问题和拉取请求。

许可证

MIT