korovin-aa97/talkthrough-mcp

korovin-aa97

Локальный MCP-сервер для Claude Code и Codex, который превращает записи экрана и встреч в транскрипт, ключевые кадры, OCR и таймкоды для доказательных отчётов об ошибках.

talkthrough-mcp — это MCP-сервер, который принимает видео- или аудиозапись и отдаёт агенту структурированные доказательства: транскрипт, кадры, распознанный текст и привязку к времени. Нужен разработчикам, которые хотят автоматизировать создание баг-репортов и разбор инцидентов по записям.

Ключевые возможности

  • Локальная обработка видео и аудио без отправки данных в облако
  • Транскрипция речи через Whisper с разметкой по спикерам
  • Извлечение ключевых кадров и OCR для текста на экране
  • Привязка событий к реальному времени (wall-clock timestamps)
  • Готовые MCP-инструменты для Claude Code и Codex
  • Поддержка публичных видеоссылок и локальных файлов .mov/.mp4

Для каких задач подходит

  • Автоматическое создание черновика issue по записанному багу
  • Разбор записей встреч и воркшопов с извлечением цитат и кадров
  • Анализ инцидентов на продакшене по видео с экрана
  • Подготовка доказательной базы для отчёта без ручного просмотра
  • Извлечение текста и таймкодов из демонстраций продукта

Подробнее

Сервер работает как MCP-провайдер: вы передаёте ему файл или ссылку, а он локально индексирует запись, разбивая её на транскрипт, ключевые кадры, OCR-текст и временные метки. В отличие от облачных решений, все вычисления идут на вашей машине, а ffmpeg, OCR и модели Whisper подтягиваются автоматически при первом запуске. Это снимает необходимость в системных зависимостях, кроме uv.

Агент получает не просто текст, а связную структуру доказательств: каждый фрагмент привязан к конкретному времени и кадру, что позволяет строить отчёты с точными ссылками. Поддерживаются сценарии с записью багов, встреч и инцидентов. Важно учитывать, что для видео без аудиодорожки транскрипт будет пустым, а первичная обработка может требовать загрузки моделей и сборки ffmpeg, что занимает время и трафик.

Частые вопросы

Как установить talkthrough-mcp?

Основная команда установки из README:

uvx talkthrough-mcp

Какие задачи решает talkthrough-mcp?

Инструмент решает задачи автоматического извлечения структурированных данных из видеозаписей: транскрипции, ключевых кадров, OCR и временных меток. На основе этих данных агент может подготовить черновик баг-репорта или провести анализ инцидента без ручного просмотра записи.

Какие требования к окружению для запуска talkthrough-mcp?

Нужен только uv; Python 3.11–3.13 и зависимости сервера устанавливаются автоматически. Системный ffmpeg не обязателен, так как используется встроенная сборка, а модели Whisper и OCR скачиваются при первом использовании.

Как подключить сервер к Claude Code или Codex?

Сервер запускается как MCP-сервер через uvx, после чего его нужно добавить в конфигурацию MCP-клиента (Claude Code или Codex). Инструменты вызываются через стандартный протокол MCP, например /talkthrough:bug для создания черновика issue.

Можно ли использовать talkthrough-mcp в коммерческих проектах?

Да, проект распространяется под лицензией MIT, которая разрешает коммерческое использование, изменение и распространение при сохранении уведомления об авторских правах.