@cocrates/video-edit-mcp

YAML/JSON edit spec으로 영상을 검증·렌더하는 CLI 및 MCP 서버입니다.
계약: spec/edit-spec.md.
렌더: Remotion (@remotion/bundler + @remotion/renderer).

요구 사항

• Node.js ≥ 20
• 시스템 ffmpeg 별도 설치 불필요 (Remotion 4가 인코딩·프레임 추출에 쓰는 바이너리를 관리)

설치

npm install
npm run build
npm link   # 선택: video-edit 명령을 PATH에 연결

엔트리

용도	경로
MCP	dist/mcp/index.js
CLI	dist/cli/index.js (video-edit)
라이브러리	dist/api.js (@cocrates/video-edit-mcp)

CLI

명령 이름: video-edit

video-edit validate ./examples/cut-concat.yaml
video-edit validate ./examples/cut-concat.yaml --resolve
video-edit render ./edit.yaml
video-edit render ./edit.yaml -o ./out/final.mp4

빌드 산출물로 직접 실행:

node dist/cli/index.js validate ./examples/cut-concat.yaml
node dist/cli/index.js render ./edit.yaml

MCP

Cursor mcp.json 예시는 examples/cursor-mcp.json.

{
  "mcpServers": {
    "video-edit-mcp": {
      "command": "node",
      "args": ["/home/drajin/work/video-edit-mcp/dist/mcp/index.js"]
    }
  }
}

연결 전:

cd /home/drajin/work/video-edit-mcp && npm install && npm run build

Tool	설명
validate_spec	스펙 검증
render_video	Remotion으로 영상 렌더

라이브러리

import { renderEditSpecFile } from "@cocrates/video-edit-mcp";
await renderEditSpecFile("./edit.yaml");

GitHub Release · npm 배포

패키지 이름: @cocrates/video-edit-mcp (scoped). npm에 퍼블리시하려면 해당 scope 권한이 필요합니다.

1. 버전 올리기

npm version patch   # 0.1.0 → 0.1.1
# 또는 minor / major
npm run build

2. npm 배포

npm login
npm publish --access public

files 필드에 dist, README.md, LICENSE만 포함되므로 publish 전에 반드시 npm run build 하세요. (dist/는 gitignore일 수 있습니다.)

3. GitHub Release

git push origin main --follow-tags

gh release create v0.1.1 \
  --title "v0.1.1" \
  --notes "$(cat <<'EOF'
## Changes
- …

## Install
npm install -g @cocrates/video-edit-mcp@0.1.1
EOF
)"

태그/릴리스는 npm version이 만든 git tag와 버전을 맞추면 됩니다.

권장 순서

1. PR 머지 → main
2. npm version + npm run build + npm publish
3. git push --follow-tags + gh release create

CI에서 publish하려면 Node 18+, NPM_TOKEN, (선택) GITHUB_TOKEN을 시크릿으로 두면 됩니다.

라이선스

Apache License