Talkthrough — MCP-сервер для Claude Code: видео в транскрипт и кадры
Локальный MCP-сервер: берёт запись с экрана или публичную ссылку на видео и превращает её в транскрипт, ключевые кадры, OCR и метки времени.
claude mcp add --env TALKTHROUGH_WHISPER_MODEL=<TALKTHROUGH_WHISPER_MODEL> --env TALKTHROUGH_OCR=<TALKTHROUGH_OCR> --env TALKTHROUGH_OCR_LANG=<TALKTHROUGH_OCR_LANG> --env TALKTHROUGH_HOME=<TALKTHROUGH_HOME> --env TALKTHROUGH_MAX_DOWNLOAD_BYTES=<TALKTHROUGH_MAX_DOWNLOAD_BYTES> --transport stdio talkthrough -- uvx talkthrough-mcpЧто делает Talkthrough
Сервер разбирает .mov или .mp4 с голосовым комментарием либо публичную ссылку. На выходе — текстовая расшифровка, отдельные кадры, распознанный с картинки текст и привязка к реальному времени записи. Всё считается на вашей машине, наружу ничего не уходит.
Внутри 9 инструментов и 6 промптов, плюс диаризация по желанию. Слэш-команды /talkthrough:bug и /talkthrough:triage-recording из плагина обвязывают всё это: агент собирает доказательства и пишет черновик issue. Загружать и постить он не станет — отправка остаётся на ваш gh или другой трекер.
Нужен uv: через uvx сервер сам подтянет Python и зависимости. Первый запуск заметно медленнее обычного, потому что process_media качает модели распознавания речи и OCR. Если системного ffmpeg нет, ставится встроенная сборка. При обновлении плагина окружение может пересобраться, и эта сборка скачается снова. Сервер нужен один раз: не ставьте одновременно вариант «только сервер» и полный плагин, иначе клиент зарегистрирует его дважды.
Какие задачи решает
- собрать расшифровку записанного баг-репорта
- вытащить кадры с ошибкой на экране из видео
- распознать текст в кадре и привязать его ко времени
- подготовить черновик issue из записи созвона
- разобрать публичную ссылку на демо без скачивания вручную
Примеры запросов агенту
- Разбери запись
checkout-bug.mp4и собери черновик issue с кадрами и таймкодами - Прогони это видео через talkthrough и найди момент, где появляется ошибка
- Сделай транскрипт записи и вытащи текст с экрана
Как установить Talkthrough
Командой платформы
claude mcp add --env TALKTHROUGH_WHISPER_MODEL=<TALKTHROUGH_WHISPER_MODEL> --env TALKTHROUGH_OCR=<TALKTHROUGH_OCR> --env TALKTHROUGH_OCR_LANG=<TALKTHROUGH_OCR_LANG> --env TALKTHROUGH_HOME=<TALKTHROUGH_HOME> --env TALKTHROUGH_MAX_DOWNLOAD_BYTES=<TALKTHROUGH_MAX_DOWNLOAD_BYTES> --transport stdio talkthrough -- uvx talkthrough-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from talkthrough-mcp <команда>
Командой платформы
codex mcp add talkthrough --env TALKTHROUGH_WHISPER_MODEL=<TALKTHROUGH_WHISPER_MODEL> --env TALKTHROUGH_OCR=<TALKTHROUGH_OCR> --env TALKTHROUGH_OCR_LANG=<TALKTHROUGH_OCR_LANG> --env TALKTHROUGH_HOME=<TALKTHROUGH_HOME> --env TALKTHROUGH_MAX_DOWNLOAD_BYTES=<TALKTHROUGH_MAX_DOWNLOAD_BYTES> -- uvx talkthrough-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from talkthrough-mcp <команда>
Файл настроек
{
"mcpServers": {
"talkthrough": {
"command": "uvx",
"args": [
"talkthrough-mcp"
],
"env": {
"TALKTHROUGH_WHISPER_MODEL": "<TALKTHROUGH_WHISPER_MODEL>",
"TALKTHROUGH_OCR": "<TALKTHROUGH_OCR>",
"TALKTHROUGH_OCR_LANG": "<TALKTHROUGH_OCR_LANG>",
"TALKTHROUGH_HOME": "<TALKTHROUGH_HOME>",
"TALKTHROUGH_MAX_DOWNLOAD_BYTES": "<TALKTHROUGH_MAX_DOWNLOAD_BYTES>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from talkthrough-mcp <команда>
Файл настроек
{
"servers": {
"talkthrough": {
"type": "stdio",
"command": "uvx",
"args": [
"talkthrough-mcp"
],
"env": {
"TALKTHROUGH_WHISPER_MODEL": "<TALKTHROUGH_WHISPER_MODEL>",
"TALKTHROUGH_OCR": "<TALKTHROUGH_OCR>",
"TALKTHROUGH_OCR_LANG": "<TALKTHROUGH_OCR_LANG>",
"TALKTHROUGH_HOME": "<TALKTHROUGH_HOME>",
"TALKTHROUGH_MAX_DOWNLOAD_BYTES": "<TALKTHROUGH_MAX_DOWNLOAD_BYTES>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from talkthrough-mcp <команда>
Командой платформы
gemini mcp add -e TALKTHROUGH_WHISPER_MODEL=<TALKTHROUGH_WHISPER_MODEL> -e TALKTHROUGH_OCR=<TALKTHROUGH_OCR> -e TALKTHROUGH_OCR_LANG=<TALKTHROUGH_OCR_LANG> -e TALKTHROUGH_HOME=<TALKTHROUGH_HOME> -e TALKTHROUGH_MAX_DOWNLOAD_BYTES=<TALKTHROUGH_MAX_DOWNLOAD_BYTES> talkthrough uvx talkthrough-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from talkthrough-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Talkthrough
Как установить Talkthrough в Claude Code?
Если нужен только сервер: claude mcp add talkthrough-mcp -- uvx talkthrough-mcp. Для полного плагина сначала /plugin marketplace add korovin-aa97/talkthrough-mcp, затем /plugin install talkthrough@talkthrough.
Что делает Talkthrough?
Индексирует видео локально: расшифровка, ключевые кадры, OCR и метки реального времени. Агент потом ищет по ним доказательства и готовит черновик issue.
Нужен ли ffmpeg в системе?
Нет. Без системного ffmpeg сервер берёт встроенную сборку, но при пересборке окружения её скачает заново.
