# Talkthrough

Локальный MCP-сервер: берёт запись с экрана или публичную ссылку на видео и превращает её в транскрипт, ключевые кадры, OCR и метки времени.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 32
- Автор: korovin-aa97
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/korovin-aa97/talkthrough-mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/talkthrough

## Что делает

Сервер разбирает `.mov` или `.mp4` с голосовым комментарием либо публичную ссылку. На выходе — текстовая расшифровка, отдельные кадры, распознанный с картинки текст и привязка к реальному времени записи. Всё считается на вашей машине, наружу ничего не уходит.

Внутри 9 инструментов и 6 промптов, плюс диаризация по желанию. Слэш-команды `/talkthrough:bug` и `/talkthrough:triage-recording` из плагина обвязывают всё это: агент собирает доказательства и пишет черновик issue. Загружать и постить он не станет — отправка остаётся на ваш `gh` или другой трекер.

Нужен `uv`: через `uvx` сервер сам подтянет Python и зависимости. Первый запуск заметно медленнее обычного, потому что `process_media` качает модели распознавания речи и OCR. Если системного ffmpeg нет, ставится встроенная сборка. При обновлении плагина окружение может пересобраться, и эта сборка скачается снова. Сервер нужен один раз: не ставьте одновременно вариант «только сервер» и полный плагин, иначе клиент зарегистрирует его дважды.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `TALKTHROUGH_WHISPER_MODEL`, `TALKTHROUGH_OCR`, `TALKTHROUGH_OCR_LANG`, `TALKTHROUGH_HOME`, `TALKTHROUGH_MAX_DOWNLOAD_BYTES` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 <команда>

## Когда брать
- собрать расшифровку записанного баг-репорта
- вытащить кадры с ошибкой на экране из видео
- распознать текст в кадре и привязать его ко времени
- подготовить черновик issue из записи созвона
- разобрать публичную ссылку на демо без скачивания вручную

## Примеры запросов агенту
- Разбери запись `checkout-bug.mp4` и собери черновик issue с кадрами и таймкодами
- Прогони это видео через talkthrough и найди момент, где появляется ошибка
- Сделай транскрипт записи и вытащи текст с экрана

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md