VidXP MCP Server

타임스탬프가 아니라 그 순간을 찾으세요

VidXP는 비디오 하나 또는 전체 컬렉션을 의미로 검색할 수 있게 해줍니다:

• 대화 검색: 누군가 했던 말을 입력하면 일치하는 순간으로 이동합니다.

• 장면 검색: 화면에 나타난 내용을 설명하면 가장 유사한 시각적 장면을 찾아줍니다.

• 동작 검색: 몇 초에 걸쳐 일어나는 동작을 설명합니다.

• 인물 매칭: 비디오 안에서 반복적으로 등장하는 얼굴을 찾고, 선택한 그룹에 대한 하이라이트 비디오를 내보냅니다.

수년간의 가족 비디오를 검색하거나, 편집 워크플로에 비디오 검색을 추가하거나, AI 에이전트가 자신의 비디오 라이브러리에서 얻은 증거를 바탕으로 질문에 답하게 할 수 있습니다. 비디오는 내 컴퓨터에 그대로 둘 수 있습니다.

Related MCP server: klaket-mcp

여기서 시작하세요

VidXP를 사용하려는 방식에 맞는 설정을 선택하세요.

1. Desktop 앱

Windows, Apple Silicon macOS, Linux용 설치 프로그램을 GitHub Releases에서 다운로드하세요.

기존 VidXP 설치를 연결하거나 데스크톱 앱이 격리된 런타임을 관리하도록 할 수 있습니다. 지원되는 설정 옵션은 Desktop 설치 지침을 참조하세요.

2. CLI 및 로컬 AI 어시스턴트

명령, 스크립트, 로컬 AI 어시스턴트를 위해 uv를 설치한 후 다음을 실행하세요:

# Install the CPU edition
uv tool install --python 3.14 --torch-backend cpu "vidxp[local-worker,mcp]"

# Check FFmpeg, download models, and verify the installation
vidxp init
vidxp prepare
vidxp doctor

# Print the settings for a local MCP client
vidxp mcp-config

브라우저 인터페이스를 추가하려면:

uv tool install --python 3.14 --torch-backend cpu \
  "vidxp[local-worker,mcp,frontend]"
vidxp ui

클라이언트별 MCP 구성, HTTP API, 원격 서버 설정은 설치 가이드를 참조하세요.

3. 서버용 Docker

홈 서버나 다른 단일 머신에서 게시된 올인원 이미지를 실행하세요:

# Download the search models into the persistent volume
docker run --rm -it \
  -v vidxp-data:/var/lib/vidxp \
  ghcr.io/grayhatdevelopers/vidxp:latest \
  vidxp prepare

# Start the browser interface
docker run --rm --init \
  -p 8501:8501 \
  -v vidxp-data:/var/lib/vidxp \
  ghcr.io/grayhatdevelopers/vidxp:latest

장기 운영 서버의 경우 latest 대신 게시된 버전을 고정하세요. Coolify 배포의 경우 게시된 -control 및 -worker 이미지를 compose.coolify.yaml과 함께 사용하세요. 저장소 빌드는 필요하지 않습니다. 전체 설정은 Coolify 가이드를 참조하세요.

지금 할 수 있는 작업

• 개별 비디오 또는 전체 컬렉션에서 검색 가능한 라이브러리를 구축하세요.

• 설명을 통해 대화, 소리 이벤트, 시각적 장면, 여러 프레임에 걸친 동작을 찾으세요.

• 근거 기반 질문을 하고 이를 뒷받침하는 보드, 프레임, 클립을 살펴보세요.

• 반복적으로 등장하는 얼굴을 그룹화하고 하이라이트된 인물 오버레이를 렌더링하세요.

• 개인, 고객, 프로젝트 라이브러리를 분리하여 유지하세요.

• 데스크톱 앱, 브라우저, CLI, MCP, HTTP API를 통해 VidXP를 사용하세요.

첫 번째 검색

브라우저 앱이 가져오기와 인덱싱을 안내합니다. 명령줄에서 동일한 흐름은 다음과 같습니다:

# Add a video
vidxp media import samplevideo.mp4 --json

# Index the returned media ID
vidxp index create <media-id>

# Find a visual moment
vidxp search scene "a yellow taxi on a city street"

# Find an action or event
vidxp search videoprism "a person opens a door and walks outside"

# Find a sound event
vidxp search sound "a dog barking over traffic noise"

# Find something that was said
vidxp search dialogue "the bread just came out of the oven"

결과에는 원본 비디오, 타임스탬프, 일치 점수, 해당 순간을 찾는 데 사용된 증거가 포함됩니다. --media-id <media-id>를 추가하면 단일 비디오만 검색합니다.

전체 명령 참조는 vidxp --help 또는 vidxp <command> --help를 실행하세요.

애플리케이션 및 AI 에이전트용

Python 패키지를 사용하여 선택한 VidXP 기능을 애플리케이션에 직접 추가하거나, VidXP를 서비스로 실행할 때 HTTP API를 사용하세요.

MCP를 사용하면 AI 클라이언트가 비디오를 추가하고 인덱싱하며, 라이브러리를 검색하고, 근거 기반 질문을 하며, 보드, 프레임, 클립과 같은 검사 가능한 증거를 반환할 수 있습니다. 로컬 클라이언트는 같은 컴퓨터에서 VidXP를 프로그램으로 시작할 수 있습니다. 호스팅된 클라이언트는 배포된 VidXP 서버에 연결합니다.

Codex 플러그인 및 스킬

VidXP는 이 GitHub 저장소에서 호스팅되는 Git 마켓플레이스를 통해 Codex 플러그인으로 배포됩니다. 여기에는 세 가지 재사용 가능한 워크플로가 포함됩니다:

• Desktop 또는 CLI를 설치하고 Codex를 연결;

• 비디오를 수집하고 인덱싱; 그리고

• 순간을 찾고 검사 가능한 증거를 반환.

이것을 Codex에 붙여넣으세요:

Add https://github.com/grayhatdevelopers/vidxp as a Git plugin marketplace, install the VidXP plugin, then use its $vidxp-install skill to set up VidXP on this computer.

VidXP Desktop은 Set up in Codex 버튼으로 동일한 설정을 수행할 수 있습니다.

호환되는 AI 클라이언트는 대화형 업로드 및 증거 검토 뷰를 표시할 수 있습니다. 해당 인터페이스가 없는 클라이언트도 일반적인 MCP 도구를 통해 동일한 워크플로 결과를 받습니다.

• Python, HTTP, MCP 설치

• 로컬 HTTP API 및 MCP 서버

• ChatGPT 및 Codex 플러그인 통합

• 선택적 기능 패키지

• Coolify 서버 설정

다운로드 및 저장 공간

첫 설정에서는 선택한 기능에 필요한 모델만 다운로드합니다. VidXP는 시작 전에 다운로드 크기와 대상 위치를 표시합니다.

Desktop이 관리하는 Python 런타임과 선택된 종속성은 약 3 GiB를 사용할 수 있습니다.

모든 검색 기능을 갖춘 전체 로컬 Desktop 설정은 약 9.0 GiB를 사용합니다. 설치 중과 인덱스, 원본 비디오, 내보낸 결과를 위해 추가 임시 공간을 확보하세요.

기본적으로 CLI와 데스크톱 앱은 동일한 VidXP 데이터 디렉터리를 공유합니다:

Docker는 동일한 데이터를 위에 표시된 vidxp-data 볼륨에 유지합니다.

제품 로드맵

다음 제품 개선은 다음에 중점을 둡니다:

• 인물 그룹에 라벨을 지정하고 서로 다른 비디오에서 동일한 인물 매칭;

• 각도, 조명, 움직임, 가려짐에 걸친 더 안정적인 얼굴 추적;

• 화면에 보이는 사람과 그들이 말하는 대화 연결;

• 라이브러리 전체에 걸친 더 나은 검색 순위, 시간 범위, 자연어 질문;

• 더 풍부한 미리보기, 타임라인, 필터, 저장된 검색, 결과 재생;

• 대규모 개인 및 프로젝트 비디오 컬렉션을 위한 더 쉬운 구성;

• 더 빠른 인덱싱과 GPU 가속 지원; 그리고

• 더 매끄러운 데스크톱 업데이트, 복구, 모델 관리.

VidXP는 베타 버전입니다. 검색 품질, 인물 워크플로, 실제 비디오 라이브러리 사용 사례에 대한 피드백이 특히 유용합니다.

도움말 및 프로젝트 링크

• 설치 및 문제 해결

• Desktop 개발

• Coolify 배포

• 변경 로그

• 이슈 트래커

• MIT 라이선스

기여

기여를 환영합니다. 풀 리에스트를 열기 전에 기여 가이드를 읽어주세요.

크레딭

VidXP는 다므 학색들의 연구 프례로젝트로 시적되었습니다:

• Abddullah Mansoor

• Muhammad Haroon

• Sara Jawad

• Talha Ahmed

연구는 NED University of Engineering and Technology의 Dr Shahab Tahzeeb 및 Grayhat의 Saad Bazaz와 함께 진행되었습니다.

VidXP는 현재 Grayhat이 구축하고 커니티 기여자들이 유지 관리합니다.

이메일: info@grayhat.studio