1.3 新增 · MCP + Skills

让 AI 助手帮你翻素材

Claude、Cursor、Codex 这些 Agent 以前看不到你硬盘里的视频。装上 Reelary，它们就能按画面内容搜你电脑上的视频和照片，再把搜到的镜头剪成片子。重活都由 Reelary 在本机干，Agent 只管开口提需求。

一行命令装好

$ npx reelary

这条命令会下载签过名的 Reelary（已经装了就不动），在后台启动（只有托盘图标，不弹窗口），接入 Claude Code、Claude Desktop、Cursor 和 Codex，再装好 Reelary Skills。重启一下 Agent，就可以开始问素材了。需要 Node.js 18 或更新版本。

也可以按需单装：

# skills only, for any of 60+ agents
$ npx skills add reelary/skills

# Claude Code plugin: skills + MCP server
/plugin marketplace add reelary/skills
/plugin install reelary@reelary

还没装软件的话，第一次问到素材时 Skills 会提醒你装。源码在 reelary/skills（Skills 和插件清单）和 reelary/cli（reelary npm 包和 MCP 服务器）。

可以这么问

• “把 ~/Movies 建好索引，找几个海边的无人机航拍。”
• “给这段旁白配空镜，从我的素材里找：…”
• “采访里她聊预算的那段在哪？”
• “用里斯本旅行的素材剪一条 30 秒的竖屏回顾。”
• “照这个脚本用我的素材出一版粗剪，导出给达芬奇。”

Agent 会找出镜头并给出精确的起止时间，给脚本的每一句配好片段和备选，存成能在 Reelary 编辑器里打开、继续修剪的项目，最后导出 MP4，或者导出给 Premiere Pro、Final Cut Pro、达芬奇用的时间线。完整演示见 用 Claude Code 按脚本粗剪（英文）。

背后是怎么跑的

Reelary 运行时会在 127.0.0.1 上开一个本地 API。Agent 启动 npx reelary mcp，这个小小的 MCP 服务器把工具调用翻译成对本地 API 的请求；Reelary 没开的话，它会在后台把它拉起来。所有碰到你文件的活儿，包括建索引、跑视觉模型、搜索、渲染，都在你电脑上的 Reelary 里完成，和你自己在界面上点是一回事。

给整块硬盘建索引、渲染导出这类耗时的活儿放在后台跑，Agent 隔一会儿查一下进度，不会卡死在一次调用上。Skills 负责教 Agent 怎么用好这些工具：什么时候该搜、什么时候该粗剪，备选镜头怎么挑，哪些功能要 Pro。

Agent 能看到什么

视频不会离开你的电脑。Agent 拿到的是文字：文件路径、时间段、每个镜头一句话的描述，有 Pro 时再加上匹配的台词。需要看画面时，每次搜索最多能要八张小预览图。Agent 收到的所有内容都会发给它背后的模型服务商，跟你在聊天框里打的字一样。如果客户项目不允许这样，就换一个跑本地模型的 Agent，或者直接用 Reelary 软件本身，它什么都不往外发。详见 AI Agent 到底能看到你素材的哪些内容（英文）。

Skills

Skill	用来干什么
reelary	入口：装好并连上 Reelary，给文件夹和硬盘建索引，常见报错也归它管。
find-footage	说出画面就能找到镜头，也能找照片、台词、人和地点（后三样要 Pro）。
broll-finder	给旁白、采访、播客的每一句配空镜。
rough-cut	脚本、大纲或分镜表直接出可编辑的粗剪，混剪和高光集锦也能做。
vertical-video	把横屏素材自动裁成 9:16 竖屏或 1:1 方形，发抖音、视频号、小红书、Shorts、Reels 都行。
nle-export	导出 FCPXML、XML 或 EDL，丢进 Premiere Pro、Final Cut Pro 或达芬奇接着精修。（Pro）

MCP 工具

工具	做什么
reelary_status	查看软件版本、授权状态和素材库有多大。
reelary_list_folders	列出素材库里有哪些文件夹。
reelary_add_folder	加入文件夹或硬盘并建索引（免费，不限数量）。
reelary_remove_folder	把文件夹移出索引，硬盘上的文件原样不动。
reelary_search	按意思搜画面，返回文件路径和精确到秒的起止时间。
reelary_rough_cut	脚本每一句配一个场景，给出最合适的片段和备选。
reelary_save_project	把草稿存成项目，能在编辑器里打开接着改。
reelary_open_in_app	在 Reelary 窗口里打开指定项目。
reelary_export_video	渲染导出 MP4（免费版有限制）。
reelary_export_nle	导出 FCPXML 或 EDL，直接引用原素材。（Pro）
reelary_job_status	查建索引、导出任务跑到哪了。
reelary_list_people	列出素材库里认出来的人。（Pro）
reelary_person_clips	找出某个人出镜的所有片段。（Pro）
reelary_list_places	列出素材的拍摄地点，来自手机、无人机和 GoPro 的 GPS。（Pro）

终端里也能直接用

同一个包也是个普通命令行工具，写脚本批量处理很方便：

$ npx reelary status
$ npx reelary index ~/Movies
$ npx reelary search "sunset over water" --json
$ npx reelary cut "Sunrise over the city. Coffee being poured." --aspect 9:16 --save Morning
$ npx reelary export <project_id> --nle fcpxml

需要准备什么

• Reelary 1.3 或更新版本，从 reelary.app 官网下载的直装版（Mac 或 Windows）。
• Node.js 18.17 或更新版本，用来跑 npx。
• 一个支持 MCP 或 Skills 的 Agent。

常见问题