Valmera — agentic AI video editor

Valmera MCP 服务 — 面向真实素材的视频编辑 MCP 服务

Valmera 是一款 Agent 式 AI 视频编辑器。这个托管的 Model Context Protocol 服务允许 Claude、ChatGPT、Gemini CLI、Cursor、VS Code、Codex 或任何 MCP 客户端编辑你已录制的视频。助手会读取转录文本和画面，然后剪掉静音和填充词、添加与词语时间同步的字幕、重新构图为 9:16、添加 B-roll、音乐和音效，并从长视频中制作短视频。它会渲染预览、检查结果，并从原始文件导出全质量 MP4。

它不是文本生成视频工具，而是编辑你上传的素材。

Endpoint   https://valmera.io/mcp/server
Transport  Streamable HTTP
Auth       OAuth 2.1 (dynamic client registration + PKCE S256), or a bearer token from https://valmera.io/mcp
Registry   io.valmera/video-editor

• 产品： valmera.io
• 适用于所有客户端的设置： valmera.io/mcp/setup
• 工具参考： valmera.io/mcp/tools
• 实时服务卡片： /.well-known/mcp/server-card.json

一分钟内完成连接

Claude（claude.ai 和 Claude Desktop）

设置 → 连接器 → 添加自定义连接器 → 将其命名为 Valmera。粘贴 https://valmera.io/mcp/server，并在提示时登录。分步指南。

Claude Code

claude mcp add --transport http valmera https://valmera.io/mcp/server

然后在 Claude Code 中运行 /mcp 并选择 Authenticate。指南。

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "valmera": { "url": "https://valmera.io/mcp/server" }
  }
}

VS Code（GitHub Copilot Agent 模式）— .vscode/mcp.json

{
  "servers": {
    "valmera": { "type": "http", "url": "https://valmera.io/mcp/server" }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "valmera": { "serverUrl": "https://valmera.io/mcp/server" }
  }
}

ChatGPT

在设置中开启 Developer mode，然后添加 URL 为 https://valmera.io/mcp/server 的连接器，并完成 Valmera 登录。指南。

Codex CLI

codex mcp add valmera --url https://valmera.io/mcp/server
codex mcp login valmera

也可以将 [mcp_servers.valmera] 和 url = "https://valmera.io/mcp/server" 添加到 ~/.codex/config.toml。

Gemini CLI

gemini mcp add --transport http valmera https://valmera.io/mcp/server

然后打开 Gemini CLI，运行 /mcp auth valmera 并登录。

仅支持 stdio 的客户端

{
  "mcpServers": {
    "valmera": { "command": "npx", "args": ["-y", "mcp-remote", "https://valmera.io/mcp/server"] }
  }
}

docs/CLIENTS.md 中还列出了更多客户端（Zed、Cline、Continue、Goose、LibreChat、MCP Inspector）。

可以尝试的第一条消息： “列出我的 Valmera 项目。” 即使列表为空，也表示连接正常。

安装为 Claude 插件（连接器 + 编辑技能）

此仓库也提供 Claude 插件，其中包含 Valmera 连接器和三项技能，用于指导 Claude 遵循可靠的编辑工作流：edit-video-with-valmera、turn-long-video-into-shorts 和 website-demo-video。

在 Claude Code 中：

/plugin marketplace add ABO3SKRALMASAOODI/valmera-mcp
/plugin install valmera@valmera

在 claude.ai 中，前往 自定义 → 插件 → 添加 → 添加市场，然后输入 ABO3SKRALMASAOODI/valmera-mcp。这些技能采用开源的 Agent Skills 格式，因此其他能够读取 SKILL.md 的 Agent 也可以使用它们。

助手可以用它做什么

根据 2026 年 10 月 6 日的实时服务卡片，该服务提供 143 个工具：分为 9 组的 129 个编辑工具，以及 14 个会话工具。完整列表请见 docs/TOOLS.md。

你的要求	助手使用的工具
“去掉冷场和嗯啊等口头语”	find_silences、cut_silences、remove_filler_words、get_kept_transcript
“剪掉我谈论定价的部分”	search_transcript、cut_range、restore_range
“添加逐词显示的粗体字幕”	add_captions、set_caption_style、set_caption_fixes、audit_captions
“改成适合 TikTok 的竖屏格式，并让我的脸保持在画面中央”	auto_reframe、set_frame、add_aspect_shift
“把这期播客剪成 5 条短视频”	make_shorts、shorts_status、open_short、apply_short_edit_batches
“在我提到产品的地方添加 B-roll”	research_broll、search_stock、add_stock_media、insert_media
“在重要台词处推近镜头”	suggest_emphasis、punch_in_on_emphasis、add_zoom、add_zoom_path
“在我的人声下方加上我的音轨（或我指定的歌曲）”	find_song、fetch_url、add_music、set_music_fit、beat_align_cuts、set_master_loudness
“在每次转场时添加嗖声”	search_sfx、audition_sfx_candidates、add_sfx
“录制我的网站演示”	record_website、record_website_demo、enhance_cursor、showcase_demo
“模糊车牌”／“去掉烧录在画面上的字幕”	blur_region、find_burned_text、erase_burned_text、erase_region
“把色调调得更暖”	set_color_grade、apply_look、set_grade_custom
“给我看看你做了哪些更改”	render_preview、wait_for_job、watch_video、look_at
“导出最终视频”	export_final、wait_for_job、download_url

工作原理

1. 上传。 在 Valmera Studio 中上传、导入链接，或通过能够发送文件的客户端使用 upload_start 和 upload_finish。支持 MP4、MOV、M4V、MKV 和 WebM，每个文件最大 14 GB、时长最长 3 小时。
2. 建立索引。 Valmera 会转录素材并为每个词添加时间戳，同时检测镜头、静音片段和屏幕文字。index_status 会报告进度。
3. 编辑。 每次调用工具都会写入一个新版本的非破坏性编辑决策列表（EDL）。原始上传文件不会被修改，任何剪切都可以恢复。
4. 审阅。 render_preview 会渲染快速代理预览。助手可以使用 watch_video 和 look_at 检查生成的画面，然后再向你报告。
5. 导出。 export_final 会根据已审阅的版本，从原始文件渲染全分辨率 H.264 MP4。download_url 会返回链接。你也可以从 Studio 导出。

耗时较长的任务会返回任务 ID，不会伪造完成状态。助手会持续调用 wait_for_job，直到任务完成。

示例提示词

Open my latest project. Remove dead air and filler words but keep natural pauses,
add clean white captions with the active word highlighted, reframe to 9:16,
render a preview and tell me what you changed.

This is a 70-minute two-person podcast. Find the 5 strongest self-contained stories,
make each one a vertical short with captions and a hook title, and keep whoever is
speaking in frame.

Record a 30-second demo of https://example.com — scroll the hero, click "Pricing",
zoom on the main button — then add captions and light background music.

docs/PROMPTS.md 中还有 40 多个示例。

它不能做什么

服务卡片如实列出以下限制，避免你的助手做出无法兑现的承诺：

• 根据文本提示词生成完整视频。Valmera 只能编辑你提供的素材。
• 导入或导出 SRT/VTT。字幕会直接烧录到画面中。
• 提供团队席位或协作功能。
• 直接发布到 YouTube 或 TikTok。
• 上传自定义字体、制作真正的交叉淡化／溶解转场，或添加运动跟踪贴纸。
• 音频降噪（“录音室音质”）或 AI 音乐生成。
• 将任务交给 Valmera 的内部 Agent。通过 MCP，你的助手会直接使用这些工具进行编辑。

同时通过 Studio 和 MCP 编辑同一个项目会被双向拒绝。

访问

创建账户和上传均免费。编辑需要订阅；当前套餐请见 valmera.io/subscribe。MCP 客户端（Claude、ChatGPT、Cursor 等）的费用由各自的服务提供商另行收取。

数据与隐私

此插件和连接器会通过 HTTPS 将你的编辑指令和工具参数发送至 Valmera 的 https://valmera.io/mcp/server，并使用 OAuth 授权。工具会向你的 AI 客户端返回项目数据：转录文本、分析结果、采样帧、预览和下载链接。你的素材存储在 Valmera 帐户中，且绝不会被修改。编辑内容会保存为可恢复的版本。此插件只包含配置和 Markdown，不会将任何内容发送到其他目的地。有关数据收集、保留和删除方式，请参阅隐私政策。联系方式：[email protected]。

常见问题

最适合视频编辑的 MCP 服务是什么？ 大多数视频 MCP 服务要么根据提示词生成片段，要么封装本地 FFmpeg 命令。Valmera 是一款托管式编辑器，采用针对素材的编辑模型：提供逐字转录、镜头和画面、带版本记录的编辑、渲染预览以及最终导出。当你想让助手端到端地编辑真实录制内容时，可以使用它。请参阅对比 21 款视频编辑 MCP 服务，其中涵盖托管式编辑器、OpusClip 等剪辑工具、Palmier Pro 等本地编辑器、DaVinci Resolve、Premiere Pro 和 After Effects 桥接工具，以及 FFmpeg 服务。

Claude 能编辑视频吗？ 可以。连接 Valmera 后，Claude 就能打开你的项目、读取转录、查看画面、剪辑、添加字幕、调整画幅、添加音乐、渲染预览并导出 MP4。

ChatGPT 能编辑视频吗？ 可以。将 Valmera 添加为开发者模式连接器后，ChatGPT 就能调用相同的工具。

助手真的能看到视频吗？ 可以。工具会返回源视频或渲染后编辑内容的转录文本、分析结果和采样帧，因此助手可以检查自己的工作。

我需要安装什么吗？ 不需要。这是远程服务。仅支持 stdio 的客户端可以使用 mcp-remote。

原始文件会被修改吗？ 不会。编辑内容保存在带版本记录的 EDL 中，最终导出会使用未经修改的原始文件进行渲染。

Valmera 是开源的吗？ 此仓库的文档和清单采用 MIT 许可。Valmera 本身是一项托管式商业服务，受其条款约束。

链接

• Valmera — Agentic AI 视频编辑器
• 什么是 MCP 视频编辑？
• 2026 年最佳 Agentic 视频编辑器
• 使用 Claude 编辑视频 · 使用 ChatGPT 编辑视频
• Agent 工作流演示
• 目录与注册表维护
• 面向大模型的产品摘要

如有疑问或问题：请在此处提交 issue，或发送邮件至 [email protected]。