Whisper STT MCP
fxckcode/whisper-stt-mcp
Transcrição de áudio local rápida com GPU NVIDIA, 100% privada
Ver no GitHubServidor MCP para transcrição de áudio local de alta qualidade usando faster-whisper com aceleração GPU NVIDIA. Suporta 99+ idiomas, detecção de voz (VAD), processamento em lote e múltiplos formatos de áudio. Totalmente offline — seu áudio nunca sai da máquina.
Instalação
npx convez-ai fxckcode/whisper-stt-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Transcrição de podcasts e entrevistas em lote
- Documentação de reuniões e conferências sem enviar áudio à nuvem
- Processamento de repositórios de áudio com detecção automática de idioma
- Integração em pipelines de automação que exigem privacidade total
Veredito

Ferramenta robusta e bem documentada para quem precisa transcrever áudio localmente com qualidade e privacidade garantidas. Requer setup técnico (GPU NVIDIA, Python 3.11+, ffmpeg) e é ideal para casos de uso em produção.
README
A tradução para o português deste README ainda está na fila.
whisper-stt-mcp
MCP server for local high-quality audio transcription using faster-whisper (CTranslate2) with NVIDIA GPU acceleration.
🎯 100% local — tu audio nunca sale de tu máquina.
Features
- 4 MCP tools:
transcribe,list_models,download_model,transcribe_batch - Any Whisper model: tiny, base, small, medium, large-v3
- GPU acceleration: NVIDIA CUDA + INT8 quantization (large-v3 en ~2.5GB VRAM)
- VAD: Voice Activity Detection con silero-vad para filtrar silencios
- Auto language detection: 99+ idiomas
- Word-level timestamps
- Batch processing: transcribe directorios enteros
- Auto format conversion: mp3, wav, m4a, ogg, flac, opus, webm (via ffmpeg)
Quick Start
# Install
git clone https://github.com/fxckcode/whisper-stt-mcp.git
cd whisper-stt-mcp
uv venv
uv pip install -e .
# Smoke test
.venv/bin/python tests/test_smoke.py
Requirements
| Dependency | Why | Install |
|---|---|---|
| Linux + NVIDIA GPU | Inference acceleration | nvidia-smi to verify |
| Python 3.11+ | Runtime | python3 --version |
| ffmpeg | Audio format conversion | sudo pacman -S ffmpeg (Arch/CachyOS) |
| uv | Package manager | `curl -LsSf https://astral.sh/uv/install.sh |
Usage
With Hermes Agent
Add to ~/.hermes/config.yaml:
mcp_servers:
whisper-stt:
command: "/path/to/whisper-stt-mcp/.venv/bin/python"
args: ["-m", "whisper_stt_mcp"]
Restart Hermes. Tools appear as mcp_whisper_stt_transcribe, etc.
With any MCP client (Claude Desktop, Cursor, etc.)
{
"mcpServers": {
"whisper-stt": {
"command": "/path/to/whisper-stt-mcp/.venv/bin/python",
"args": ["-m", "whisper_stt_mcp"]
}
}
}
Via CLI (one-shot)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"transcribe","arguments":{"file_path":"/path/to/audio.mp3","model":"medium"}}}' \
| .venv/bin/python -m whisper_stt_mcp
Tools
transcribe
| Param | Type | Default | Description |
|---|---|---|---|
file_path | string | required | Absolute path to audio file |
model | string | "medium" | Model size |
language | string | null (auto) | ISO code ("es", "en", etc.) |
vad | boolean | true | Voice Activity Detection |
word_timestamps | boolean | true | Per-word timestamps |
temperature | number | 0.0 | Sampling temperature |
beam_size | integer | 5 | Beam search size |
list_models
No params. Returns available + downloaded models.
download_model
| Param | Type | Description |
|---|---|---|
model | string | Model to download (tiny/base/small/medium/large-v3) |
transcribe_batch
| Param | Type | Default | Description |
|---|---|---|---|
directory | string | required | Directory with audio files |
pattern | string | "*.{mp3,wav,m4a,ogg,flac}" | Glob pattern |
model | string | "medium" | Model size |
language | string | null (auto) | ISO code |
vad | boolean | true | VAD |
word_timestamps | boolean | false | Word timestamps (off for speed) |
Performance
| Model | VRAM | Speed (RTX 3050) | Quality |
|---|---|---|---|
| tiny | ~0.5 GB | 20x real-time | Low |
| base | ~0.8 GB | 15x real-time | Fair |
| small | ~1.5 GB | 10x real-time | Good |
| medium | ~2.0 GB | 6x real-time | Recommended |
| large-v3 (INT8) | ~2.5 GB | 4x real-time | Best |
Project Structure
whisper-stt-mcp/
├── pyproject.toml
├── README.md
├── src/whisper_stt_mcp/
│ ├── __init__.py
│ ├── __main__.py # Entry point
│ ├── server.py # MCP tools
│ ├── transcriber.py # faster-whisper wrapper
│ ├── audio.py # ffmpeg conversion
│ ├── models.py # Model cache mgmt
│ └── vad.py # Voice Activity Detection
├── tests/
│ └── test_smoke.py # Smoke test suite
└── hermes-skill/
└── SKILL.md
License
MIT