Video Material DB (семантическая база видеоматериалов)

Локальная база знаний для исследования и создания коротких видео. Она сохраняет видео, субтитры и результаты структурированного ИИ-анализа в PostgreSQL и предоставляет поиск по естественному языку через веб-интерфейс, REST API и инструменты MCP. Материалы и данные анализа по умолчанию хранятся в пользовательском окружении.

Основные функции

• Импорт материалов из локальных файлов, папок или публичных видеоссылок

• Получение списков видео блогеров с платформ 抖音, TikTok, YouTube, B站 и др.

• Автоматическая предобработка видео, транскрипция речи, извлечение ключевых кадров и визуальный анализ

• Извлечение персонажей, сцен, кадров, диалогов, структуры сюжета, шуток и рекомендаций по адаптации

• Создание семантического индекса с помощью pgvector для поиска видео, реплик и сюжетных элементов по естественному языку

• Управление материалами и фоновыми задачами через веб-интерфейс FastAPI

• Подключение таких ИИ-инструментов, как Codex, через MCP

• Поддержка дедупликации материалов, асинхронной обработки, повторных попыток при сбоях и пакетного экспорта

Related MCP server: VidCap YouTube API MCP Server

Сценарии применения

• Сценаристы коротких видео находят сюжет, реплики, шутки, повороты и примеры кадров

• Контентные команды создают поисковую библиотеку видеопримеров и базу креативных знаний

• Анализ структуры контента, повествовательного ритма и визуальной подачи популярных блогеров

• Поиск пригодных для повторного использования творческих паттернов в большом количестве референсных видео

• Предоставление ИИ-ассистентам структурированных и прослеживаемых видеоматериалов для исследования

Технологический состав

• Python 3.11+

• FastAPI

• PostgreSQL + pgvector

• MCP Server

• ffmpeg / ffprobe

• Интерфейс, совместимый с 通义千问 (ASR, визуальный анализ и векторные эмбеддинги)

Быстрый старт

Полные шаги по установке приведены в INSTALL.md. Материалы по умолчанию сохраняются в локальной папке ./data в каталоге проекта.

python3 -m venv .venv
.venv/bin/pip install -e .
cp .env.example .env

После запуска базы данных запустите отдельно веб-сервис и фоновые задачи анализа:

.venv/bin/video-db-api
.venv/bin/video-db-worker

Откройте в браузере http://127.0.0.1:8000/.

Подключение MCP

codex mcp add video-material-db -- <仓库绝对路径>/.venv/bin/video-db-mcp

Доступные инструменты включают add_video_url, add_local_video, search_videos, search_dialogue, search_jokes, search_story_structure и get_video_detail.

Данные и безопасность

Публичный репозиторий содержит только общий исходный код программы. .env, API-ключи, видеофайлы, содержимое базы данных, резервные копии, локальные пути и личные данные никогда не попадают в систему контроля версий.