mcpField
K
klo-mcp

klo-mcp

本地服务
github.com/elvniv媒体与设计010 周前更新

关于 klo-mcp

klo-mcp 将编码 Agent 等 MCP 客户端连接到原生 macOS 视频编辑器 klo。它通过语义化时间线操作控制剪辑,媒体保留在 Mac 上,编辑结果可在人类可操作的时间线上继续调整。

主要功能

  1. 01使用 83 种工具控制视频时间线
  2. 02执行剪切、转场和字幕编辑
  3. 03调整色彩、动态效果和音频
  4. 04检查转录文本和视频帧
  5. 05导出视频,包括 ProRes

适用场景

  1. 01删除语气词并添加逐词字幕
  2. 02根据转录内容拼接选定镜头
  3. 03参照样片调整色彩
  4. 04将客户视频导出为 ProRes

MCP 相关

该服务通过本地 HTTP 端点或 stdio 服务将 MCP 客户端连接到 klo。它提供 83 种用于时间线编辑、媒体检查、生成和导出的工具;媒体保留在 Mac 上。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"com-getklo-klo": {
"command": "npx",
"args": [
"-y",
"klo-mcp"
],
"env": {
"KLO_MCP_TOKEN": "<KLO_MCP_TOKEN>"
}
}
}
}
启动命令npx -y klo-mcp
需要配置的环境变量
KLO_MCP_TOKEN密钥Connection token from klo Settings > Connections

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmklo-mcp2.7.0

工具

3

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

klo,你可以通过对话使用的原生 Mac 视频编辑器

klo-mcp:视频编辑 MCP 服务

npm license platform site

为你的编码 Agent 提供一个真正的视频编辑器。

klo 是一款可通过对话操作的原生 macOS 视频编辑器。这是它的 MCP 服务:Claude Code、Codex、Cursor、Claude Desktop 或任何 MCP 客户端,都可以通过 83 个工具操控整个时间线,而你的视频素材始终不会离开 Mac。

  • 底层是真正的编辑器。 不是 ffmpeg 封装:支持波纹剪辑、词间空隙剪辑、卡拉 OK 字幕、调色、生成音乐和 ProRes 导出。每次剪辑都会落在普通时间线上,人可以打开并调整。
  • 媒体留在本地。 通过文本协议传输视频字节行不通(base64 与上下文窗口不兼容)。klo 会将媒体保存在你的设备上,并提供语义化的时间线操作。Agent 发送意图,收到精简的结果:时间码、转录文本,以及需要查看时提供的真实画面。
  • 本地运行、令牌验证、默认关闭。 服务仅监听 127.0.0.1,需要持有者令牌,且只有在 klo 的设置中启用后才会运行。

快速开始

  1. 获取 Mac 版 klo(包含免费套餐,macOS 13+)。
  2. 在 klo 中:打开 设置 → 连接,启用连接,然后复制显示的 URL 和令牌。
  3. 连接你的客户端:
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

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。