关于 klo-mcp
klo-mcp 将编码 Agent 等 MCP 客户端连接到原生 macOS 视频编辑器 klo。它通过语义化时间线操作控制剪辑,媒体保留在 Mac 上,编辑结果可在人类可操作的时间线上继续调整。
主要功能
- 01使用 83 种工具控制视频时间线
- 02执行剪切、转场和字幕编辑
- 03调整色彩、动态效果和音频
- 04检查转录文本和视频帧
- 05导出视频,包括 ProRes
适用场景
- 01删除语气词并添加逐词字幕
- 02根据转录内容拼接选定镜头
- 03参照样片调整色彩
- 04将客户视频导出为 ProRes
MCP 相关
该服务通过本地 HTTP 端点或 stdio 服务将 MCP 客户端连接到 klo。它提供 83 种用于时间线编辑、媒体检查、生成和导出的工具;媒体保留在 Mac 上。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 2 周前
此工具无需参数。
详细介绍
klo-mcp:视频编辑 MCP 服务
为你的编码 Agent 提供一个真正的视频编辑器。
klo 是一款可通过对话操作的原生 macOS 视频编辑器。这是它的 MCP 服务:Claude Code、Codex、Cursor、Claude Desktop 或任何 MCP 客户端,都可以通过 83 个工具操控整个时间线,而你的视频素材始终不会离开 Mac。
- 底层是真正的编辑器。 不是 ffmpeg 封装:支持波纹剪辑、词间空隙剪辑、卡拉 OK 字幕、调色、生成音乐和 ProRes 导出。每次剪辑都会落在普通时间线上,人可以打开并调整。
- 媒体留在本地。 通过文本协议传输视频字节行不通(base64 与上下文窗口不兼容)。klo 会将媒体保存在你的设备上,并提供语义化的时间线操作。Agent 发送意图,收到精简的结果:时间码、转录文本,以及需要查看时提供的真实画面。
- 本地运行、令牌验证、默认关闭。 服务仅监听
127.0.0.1,需要持有者令牌,且只有在 klo 的设置中启用后才会运行。
快速开始
- 获取 Mac 版 klo(包含免费套餐,macOS 13+)。
- 在 klo 中:打开 设置 → 连接,启用连接,然后复制显示的 URL 和令牌。
- 连接你的客户端:
Claude Desktop(一键安装)
下载 klo.mcpb 并打开即可。
Claude Code
claude mcp add --transport http klo http://127.0.0.1:41720/mcp \
--header "Authorization: Bearer YOUR_TOKEN"
请使用 klo 设置中显示的准确 URL(如果 41720 端口已被占用,端口号可能不同)。
Cursor、Codex 和其他 MCP 客户端
可以将客户端指向上面的 HTTP 端点,也可以将此包用作 stdio 服务:
{
"mcpServers": {
"klo": {
"command": "npx",
"args": ["-y", "klo-mcp"],
"env": { "KLO_MCP_TOKEN": "YOUR_TOKEN" }
}
}
}
Agent 能做什么
用自然语言提出要求,也可以直接调用工具。以下是一些实际提示词:
- “剪掉无聊的部分和填充词,然后逐词添加字幕。”
- “监视这个文件夹,把每段新录制的视频都制作成带字幕的竖屏片段。”
- “根据转录文本,为每句话挑选最佳片段并剪辑成片。”
- “按照这个参考视频为所有内容调色,并为客户导出 ProRes。”
83 个工具
| 分组 | 工具 |
|---|---|
| 库 | get_project_state, get_media_library, import_media, import_from_url, relink_to_sources, list_files, new_project |
| 时间线 | add_media_to_timeline, assemble_cut, insert_at, move_clip, split_clip, split_audio, trim_clip, delete_clips, ripple_delete, close_gaps, separate_audio, unlink_clip, link_clips, replace_audio, add_marker, set_in_out, set_track_lock, seek, verify_timeline |
| 项目 | set_canvas_ratio, set_frame_rate, set_brand_kit |
| 剪辑 | add_transition, remove_transition, preview_cut, generate_transition, refine_transition |
| 文字 | add_text, update_text, add_captions_from_transcript, list_text_styles, list_fonts, search_fonts, use_font |
| 动效 | list_motion_templates, create_motion_clip, update_motion_clip |
| 色彩 | set_clip_grade, add_clip_effect, update_clip_effect, remove_clip_effect, list_luts, import_lut, set_clip_opacity, set_clip_blend |
| 画面 | set_clip_transform, set_clip_speed |
| 音频 | set_clip_audio, set_volume_envelope, duck_audio, analyze_audio, quantize_cuts_to_beats, isolate_voice_on_clip, measure_audio, measure_mix |
| 生成 | generate_music, generate_sfx, generate_voiceover, clone_voice_from_clip, fix_spoken_line, generate_video |
| 读取 | get_transcript, find_repeated_takes, capture_frame, survey_footage, measure_frame, measure_clip |
| 记忆 | write_footage_notes, get_footage_notes, analyze_reference, save_style_profile, list_style_profiles, apply_style_profile |
| 输出 | delegate_research, web_search, export_video |
定价
通过 MCP 操作时间线免费:Agent 使用自己的模型。少数用于生成新媒体素材(音乐、旁白、生成镜头)的工具会消耗 klo 账户额度,Agent 会在消费前获知价格。新账户可免费体验 10 次。
安全说明
- 仅监听
127.0.0.1。不会向网络公开任何内容。 - 使用持有者令牌认证,并通过恒定时间比较进行验证。可随时在 klo 设置中轮换令牌。
- 默认关闭。如果 klo 正在运行但连接未开启,服务会明确告知 Agent。
- 应用中的语音克隆工具需要获得同意。
故障排除
“klo 正在运行,但不接受连接”:在 klo → Settings → Connections 中开启桥接,然后将令牌复制到 KLO_MCP_TOKEN(或 HTTP 的 Authorization 标头)中。
端口与 41720 不同:如果首选端口已被占用,klo 会改用临时端口。请始终以 Settings 中显示的 URL 为准。
关于
此软件包是轻量级连接器;编辑器本身是 klo。连接器与应用内捆绑的副本保持一致,其主版本号和次版本号对应于随之发布的应用版本。
常见问题
Claude Code 能剪辑视频吗? 安装 klo 后即可。Claude Code 可连接到此服务,并在实际时间线上使用剪辑、字幕、调色、生成音乐和旁白以及 ProRes 导出功能。请参阅什么是 Agentic 视频剪辑。
这是 ffmpeg 封装工具吗? 不是。工具直接操作 klo 的时间线(波纹剪辑、词间停顿剪辑、撤销),各步骤之间不会重新编码。了解此设计的原因。
我的素材会被上传吗? 不会。媒体留在 Mac 上;服务只交换时间线操作和精简结果。详情请见 klo 的隐私政策。
费用是多少? 使用自己的模型操作时间线免费。生成工具会消耗 klo 账户额度。定价。
延伸阅读
MIT(本连接器)。klo 是 klorah inc. 的产品。 getklo.com
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
