로컬 동영상 미디어 (MCP)
VidSeeds.ai는 클라이언트 우선 미디어 방식을 따릅니다. 호스팅된 MCP 서버는 사용자 컴퓨터의 파일을 읽지 않습니다. 도구는 레시피(ffmpeg/ffprobe 명령어)를 반환하거나 에이전트가 로컬에서 추출한 base64 프레임을 받습니다.
파일 프로브
vidseeds_probe_local_video- 길이, 해상도, 코덱; 트림이나 썸네일 프레임 선택 전에 사용합니다.
프레임 및 클립
| 목적 | 도구 |
|---|---|
| 썸네일용 정지 프레임 | vidseeds_extract_video_frames |
| 컨텍스트용 짧은 클립 | vidseeds_extract_video_clip |
| 일반 트랜스코딩 레시피 | vidseeds_transcode_format_recipe |
| 미디어 도우미 명령어 | vidseeds_get_local_media_recipe |
반환된 셸 명령어는 사용자 컴퓨터에서 실행합니다(ffmpeg/ffprobe가 설치되어 있어야 함). 필요한 경우 결과를 썸네일 도구에 frames로 전달하여 vidseeds_generate_thumbnail에 사용합니다.
정밀 트림
vidseeds_analyze_precision_trim- 제안된 컷 포인트, 세그먼트 카탈로그, 시드 비용 미리보기.vidseeds_plan_precision_trim- AI 편집 계획(CritiquePlan)으로 장르 인식 처리.vidseeds_execute_precision_trim- 로컬 ffmpeg를 위한 내보내기 레시피/명령어.
V3 장르 인식 처리 (2026-06-27)
정밀 트림 V3는 장르 분류 + 사운드스케이프 분석 + 모션 프로필 + 훅 감지 + 의미 경계를 병렬 클라이언트 측 신호로 추가합니다. 이들은 vidseeds_analyze_precision_trim / vidseeds_plan_precision_trim 입력에서 선택적 메타데이터로 전달됩니다:
detectedGenre- 자동 장르 감지를 재정의합니다 (speech_driven, action_dynamic, ambient_relax, visual_primary, mixed_narrative, tutorial)soundscape- PCM에서 얻은 스펙트럼 분류 (silence/speech/music/ambient/noise)motionProfile- 프레임별 픽셀 차이 분석 (static/slow/action/scene_change)
계획에 미치는 영향:
- ambient_relax: 높은 침묵 허용치(15초 이상), 무음 장면 보존, 20% 미만 컷 비율
- action_dynamic: 공격적인 일시 정지 트리밍(500ms 이상), 최대 40% 컷 비율
- speech_driven: 의미 경계에서 컷, 적당한 트리밍
- visual_primary: 음성이 없는 장면 보존, 진정한 침묵에서만 컷
- mixed_narrative: 모든 신호 사용 - 다수가 동의할 때만 컷
- tutorial: 정밀 트리밍, 지침 주변 속도 변경 없음
미드롤 배치
vidseeds_analyze_midroll_opportunities- 대본/컨텍스트에서 제안된 미드롤 시간 (분석만; 사용자가 편집기에서 편집).
로컬 파일의 썸네일
전체 파이프라인이 디스크에서 실행되어야 하는 경우 vidseeds-local stdio MCP 도구 vidseeds_generate_thumbnail_from_video를 선호합니다 (vidseeds-thumbnails 참조).
YouTube 호스팅 소스 (로컬 경로 아님)
vidseeds_get_youtube_video_transcript,vidseeds_get_youtube_video_captions- 서버에 동영상을 다운로드하지 않고 YouTube에서 텍스트를 가져옵니다.
금지 사항
- 호스팅된 도구가 업로드/처리를 위해 임의의 파일 시스템 경로를 받을 것으로 기대하지 마십시오.
- 프로브/추출을 반복해서 실행하지 마십시오. 세션 동안 프로브 결과를 캐시하십시오.