AI · MCP
让 AI 帮你剪,
让 AI 帮你剪,
你在旁边看着。
内容工厂内置一个本机 MCP 服务。Claude Code、Claude Desktop 等 AI 助手连上之后,可以读懂时间线、看成片画面、动手剪辑和导出。它改的每一步都显示在界面上,都能撤销。
截图来自软件的自动化截图测试,素材为测试图案。
它是怎么工作的
- MCP 协议。软件启动后在本机运行 MCP 服务(Streamable HTTP,默认端口 39917,只监听 127.0.0.1),需要令牌才能连接。另带一个命令行程序
cf,cf mcp提供 stdio 方式的 MCP,给 Claude Desktop 这类“启动一个命令”的客户端用。 - 53 个工具。观察(读工程、时间线、片段、素材、字幕、后台任务)、编辑(导入、插入、移动、修剪、分割、删除、变速、音量、画面、关键帧、调色、滤镜、转场、文字、自动字幕、去口误、绿幕抠图、重新链接……)、输出(导出视频、SRT、单帧)、导航(打开工程、切换面板、移动播放头、播放一段给你看)。
- AI 能“看”。
render_frame返回某一帧的成片画面,contact_sheet把一段时间均匀抽帧拼成一张图。它们和导出用同一个渲染器,AI 看到的就是最终成片。 - 每一步都能撤销。AI 的每次修改都是一个撤销步骤,标成「AI:……」,和你自己的操作在同一个撤销列表里。
apply_ops可以把多步修改合成一步:要么全部成功,要么都不生效。 - 不会和你抢着改。工程每变一次修订号加一。AI 提交修改时带上它读到的修订号;如果这期间你改过,修改会被拒绝,并把最新状态返回给 AI,让它重新读取再改。
- 没有界面也能跑。
cf可以直接处理工程文件:cf info看概要,cf apply批量执行修改,cf render按抖音、快手、视频号、小红书、B 站、YouTube 等预设出片,cf transcribe识别字幕,cf frame/cf contact-sheet出图。适合脚本和批量处理。
你能看到 AI 在做什么
- 窗口顶部出现紫色状态条「AI 正在操作 · 正在添加文字」,右侧有跟随 / 后台、撤销 AI 的修改、暂停、停止。
- 跟随:AI 打开哪个工程、切到哪个面板、看哪一帧,界面就跟到哪里。后台:界面不动,你可以接着干自己的事,标注照常出现。
- AI 用淡紫色标出它在看的位置:时间线上的 AI 播放头、预览左上角的「AI 在看 00:00:04:18」,被改动的片段旁浮出「AI:……」。
- 暂停后 AI 还能看但不能改;停止后它的请求全部被拒绝,它启动的导出和识别也会取消。
- 「撤销 AI 的修改」一键回到 AI 这次开始之前的样子,这本身也是一步撤销,可以再恢复。
- 导出到新文件夹、覆盖已有文件、删除素材、下载扩展,第一次都会弹窗问你;同意后本次会话内同类操作不再询问。
接入
打开内容工厂,点标题栏右侧的「AI」按钮,面板里会显示服务状态、地址和令牌,以及下面这几段配置,点「复制」即可(令牌是你自己电脑上随机生成的,可以随时重新生成)。
Claude Code(在终端运行)
claude mcp add --transport http contentfactory http://127.0.0.1:39917/mcp --header "Authorization: Bearer <你的令牌>"
Claude Desktop(claude_desktop_config.json)
{
"mcpServers": {
"contentfactory": {
"command": "/Applications/内容工厂.app/Contents/MacOS/cf",
"args": ["mcp"]
}
}
}
软件开着时,cf mcp 会把请求转发给软件,你能在界面上看到 AI 操作;软件没开时,它直接处理工程文件。Windows 上 cf.exe 在安装目录(默认 %LOCALAPPDATA%\Programs\ContentFactory)里;面板里复制出来的就是你电脑上的实际路径。
其他支持 MCP 的客户端(Streamable HTTP)
{
"mcpServers": {
"contentfactory": {
"type": "http",
"url": "http://127.0.0.1:39917/mcp",
"headers": { "Authorization": "Bearer <你的令牌>" }
}
}
}
端口 39917 被占用时会自动换一个,以面板里显示的地址为准。
可以这样说
- 「把这段口播的停顿和“嗯、啊”删掉,配上字幕。」AI 依次调用
auto_subtitles(本机识别字幕)→get_transcript(拿到停顿和语气词的时间段)→remove_ranges(删掉这些区间,后面的内容自动前移)。界面上能看到每一步,不满意就撤销。 - 「改成 9:16 竖屏,开头加一个标题,然后给我看看效果。」
set_project改画幅 →add_text加标题 →render_frame取一帧成片画面自查,有问题再调整位置。 - 「快速过一遍全片,告诉我哪里节奏拖。」只读操作:
get_timeline读结构,contact_sheet抽帧看画面,然后给出建议,不改工程。 - 「按抖音的规格导出到桌面。」
export_video用 douyin 预设(1080 短边、30 帧)在后台导出;第一次写入桌面会先问你,导出进度在get_tasks里。
能做和不能做
能
- 读取工程、时间线、每个片段的参数和关键帧、字幕逐字时间
- 看到成片画面(单帧和抽帧拼图)
- 完成软件里几乎所有剪辑操作,包括批量和原子提交
- 导出视频、字幕和单帧,下载扩展(需要你同意)
- 切换界面让你跟着看,或者在后台安静地改
不能
- 不能从其他电脑连接:只监听 127.0.0.1,还要令牌
- 不能在不问你的情况下写到新位置、覆盖文件或删除素材
- 不自带 AI 模型:需要你自己的 AI 助手,剪得好不好取决于它
- 不能听声音:它通过字幕文字和画面理解内容
隐私
- 内容工厂本身不调用任何 AI 服务,也不把工程内容发到网上。MCP 服务只在本机监听,并拒绝来自其他网页的跨站请求。
- AI 助手调用工具时,会拿到工程结构、字幕文字和它请求的画面截图。这些内容是否、以及如何发送给 AI 服务商,取决于你用的 AI 客户端和它的隐私政策。
- 每一次 AI 调用(时间、客户端、工具、参数、结果、耗时)都记在你电脑上的操作日志里(数据目录下的
agent/calls.log),面板里点「操作日志」可以打开。 - 不想让 AI 连接时,在「AI」面板里关闭 MCP 服务即可。