OpenShorts, 영상 숏폼화 MCP 공개
I built an open source MCP server so Claude can turn a long video into vertical clips. The three things that broke first.
·2026.08.29 08:47
핵심 내용
오픈소스 영상 편집 도구 OpenShorts가 Claude와 연동되는 MCP 서버를 공개하며, URL 처리 및 비동기 작업 설계의 핵심 노하우를 공개했다.
자세히 보기
오픈소스 영상 편집 도구 OpenShorts가 롱폼 영상을 세로형 숏폼으로 자동 변환하는 기능을 Claude와 연동할 수 있는 MCP(Model Context Protocol) 서버를 공개했다. 이 프로젝트는 Claude Code를 기반으로 개발되었으며, 사용자가 URL만 입력하면 파이프라인이 자동으로 작동하도록 설계되었다.
개발 과정에서 가장 큰 장애물이 되었던 세 가지 기술적 문제와 해결책은 다음과 같다.
- URL 처리 및 프롬프트 설계: 초기 버전에서는 Claude가 제공된 YouTube 링크를 직접 열지 못하고 웹 검색을 시도하는 오류가 발생했다. 이를 해결하기 위해 서버 설명에 'URL은 그대로 전달되며 모델이 먼저 확인하지 않아도 된다'는 내용을 명시하여, 모델이 도구를 즉시 호출하도록 유도했다.
- 비동기 작업 처리: 영상 편집은 대화형 세션 내에서 완료하기 어려운 장기 작업이다. 따라서
process_video는 즉시 job id를 반환하고,get_job_status로 상태를 조회하며, 외부 시스템 연동을 위해webhook_url파라미터를 지원하는 비동기 아키텍처를 채택했다. - 원격 서버 인증(OAuth): 원격 MCP 서버는 RFC 9728 및 8414 메타데이터 발행, 동적 클라이언트 등록, PKCE 지원이 필수다. OpenShorts는 별도의 새로운 인증 체계를 만들지 않고, 클라이언트 이름으로 일반 API 키를 발급하는 방식을 통해 인증 경로를 단순화했다.
이 한국어 요약은 AI가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.