@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-mcp / video-edit 명령을 PATH에 연결

npx @cocrates/video-edit-mcp → MCP (video-edit-mcp). CLI는 video-edit 또는 npx --package @cocrates/video-edit-mcp video-edit.

엔트리

용도	경로
MCP	`dist/mcp/index.js` (`video-edit-mcp`, npx 기본)
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": "npx",
      "args": ["-y", "@cocrates/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와 버전을 맞추면 됩니다.

권장 순서

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

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

라이선스

Apache License