whisper-mcp

Transcripción local de Whisper, expuesta como un servidor MCP — para que cualquier cliente MCP (Claude Desktop, Claude Code, etc.) pueda transcribir archivos de audio/vídeo, generar subtítulos .srt e incrustar subtítulos en un vídeo, directamente como llamadas a herramientas. Sin API en la nube, sin el paso manual de «ejecutar un script e ir a leer el archivo de salida».

Construido sobre faster-whisper para la inferencia y ffmpeg para la extracción de audio / el incrustado de subtítulos.

Arquitectura

MCP client (Claude, etc.) --stdio--> whisper-mcp server --> faster-whisper (Whisper model)
                                                        \--> ffmpeg (audio extract / burn-in)

El servidor mantiene en memoria los modelos de Whisper cargados durante toda la vida del proceso, de modo que las llamadas repetidas a las herramientas en una misma sesión no tienen que volver a pagar el tiempo de carga del modelo.

Related MCP server: Whisper MCP Server

Herramientas

Requisitos

• Python 3.10+

• ffmpeg en PATH

• Opcional: una GPU compatible con CUDA (vuelve automáticamente a CPU)

Instalación y ejecución

pip install -e ".[dev]"
whisper-mcp

O, sin instalación:

uvx --from git+https://github.com/Chain-P/whisper-mcp whisper-mcp

Configuración en un cliente MCP

Añade esto a la configuración MCP de tu cliente (p. ej. el .mcp.json de Claude Code o el claude_desktop_config.json de Claude Desktop):

{
  "mcpServers": {
    "whisper": {
      "command": "whisper-mcp"
    }
  }
}

Luego pide al cliente que transcriba un archivo, p. ej. «transcribe samples/podcast_clip.mp4 y dame el SRT».

Desarrollo

pip install -e ".[dev]"
ruff check .
pytest                        # unit tests only
pytest -m integration         # + real transcription against a sample file

Hoja de ruta

• Diarización de hablantes (pyannote.audio / whisperx) para el etiquetado multi-hablante en la salida SRT.

• Notificaciones de progreso MCP para transcripciones largas.

• Un resource que expone el historial reciente de transcripciones.

Licencia

MIT