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, которая разрешает коммерческое использование, изменение и распространение при сохранении уведомления об авторских правах.
О репозитории
Язык
Лицензия
Звёзды
32
Форки
4
Открытые issues
7
Контрибьюторы
0
Создан
10.07.2026
Обновлён
23.10.2026