剪映 AI 编辑 MCP + Skill

首版把自然语言剪辑规划与草稿执行分离：Skill 负责需求引导、模式选择与紧凑编辑清单；MCP 负责确定性生成、参考草稿复用、批量换料、安全校验和本地阶段进度。

验证基线：剪映专业版 10.0.5.13816、pyJianYingDraft 0.3.0、MCP Python SDK 1.29.0。

目录

• src/jianying_ai_mcp/：批处理 MCP 服务

• skills/jianying-ai-editor/：可复用 Skill

• docs/capability_matrix.md：完整测试结论

• configs/：客户端配置样例

• tests/：从零生成、参考复用、批量换料及安全边界测试

Related MCP server: capcut-mcp

MCP 工具

• get_jianying_capabilities：版本、能力与限制

• analyze_reference_draft：从明文草稿提取剪辑蓝图

• build_draft：一次提交编辑清单，从零生成草稿

• build_from_reference：复制蓝图并按轨道/片段换料换字

• batch_from_template：一个模板批量生成多份草稿

工具默认 dry_run=true，会在项目暂存区完整生成和校验，但不发布到剪映目录。正式发布不会覆盖同名草稿。

本机启动

F:\构建\MCP\剪映\.venv\Scripts\python.exe -m jianying_ai_mcp

服务使用 stdio MCP；普通日志不写 stdout。客户端支持时会显示 [阶段] 日志和 progress，其他客户端仍可从返回值的 stages 查看阶段。

环境变量

• JIANYING_DRAFT_ROOT：剪映草稿根目录

• JIANYING_MCP_WORK_ROOT：暂存和参考蓝图目录

• JIANYING_EXE：剪映程序路径，用于检测版本

• JIANYING_MCP_TRANSPORT：默认 stdio，也可使用 sse 或 streamable-http

当前本机示例见 OpenCode 配置 和 通用 stdio 配置。

验证

F:\构建\MCP\剪映\.venv\Scripts\python.exe -m unittest discover -s tests -v
F:\构建\MCP\剪映\.venv\Scripts\python.exe -X utf8 C:\Users\Xanthus\.codex\skills\.system\skill-creator\scripts\quick_validate.py F:\构建\MCP\剪映\skills\jianying-ai-editor

当前边界

首版不自动操作剪映内置音乐/音效库、TTS、自动字幕/文稿识别、节拍卡点和自动导出。蒙版、模糊背景及音量关键帧因当前版本实测不稳定而被显式拒绝。参考草稿只支持明文 JSON；不调用未经源码审计的解密程序。

每次工具调用都返回版本兼容提示。若剪映版本与 10.0.5.13816 不同，客户端必须向用户说明预设、在线资源和草稿结构可能变化，并先生成小样抽检。