whisper-windows-mcp 2.2.1 → 2.2.2

package/SECURITY.pl.md

@@ -0,0 +1,47 @@
+# Polityka bezpieczeństwa
+
+## Zakres
+
+whisper-windows-mcp jest narzędziem priorytetyzującym lokalność. Całe przetwarzanie audio odbywa się na twoim komputerze — żadne audio, pliki wideo ani dane osobowe nie są przesyłane na żaden serwer. Powierzchnia ataku jest ograniczona do:
+
+- Lokalnego systemu plików (ścieżki plików przekazywane do narzędzi)
+- Binarnego pliku whisper-cli.exe i jego zależności
+- Połączenia MCP Claude Desktop (tylko lokalny IPC)
+- Tekstu transkrypcji zwracanego w odpowiedziach narzędzi (patrz Architektura prywatności poniżej)
+
+## Architektura prywatności
+
+**Pliki audio nigdy nie opuszczają twojego komputera.** Ta gwarancja jest bezwarunkowa.
+
+**Tekst transkrypcji może opuścić twój komputer.** Gdy odpowiedź narzędzia zawiera tekst transkrypcji, tekst ten jest przetwarzany przez API Claude. Jest to standardowe zachowanie MCP, ale tworzy lukę między filozofią projektowania "priorytet lokalny" narzędzia a rzeczywistym przepływem danych dla użytkowników obsługujących treści regulowane lub poufne.
+
+Planowana jest zmienna środowiskowa `WHISPER_PRIVACY_MODE`, która ograniczy wszystkie odpowiedzi narzędzi tylko do metadanych — żaden tekst transkrypcji nie jest zwracany do API Claude. Jest to planowane rozwiązanie dla wdrożeń medycznych, prawnych, finansowych i korporacyjnych.
+
+Zobacz [PRIVACY.md](PRIVACY.md) dla pełnego opisu architektury prywatności, wskazówek dotyczących ram zgodności (HIPAA, RODO, tajemnica adwokacka, FERPA, SOX, PCI-DSS) i instrukcji konfiguracji.
+
+## Obsługiwane wersje
+
+Poprawki bezpieczeństwa są stosowane tylko do najnowszej opublikowanej wersji.
+
+| Wersja | Obsługiwana |
+|---|---|
+| 2.x (najnowsza) | ✅ |
+| 1.x | ❌ |
+
+## Zgłaszanie podatności
+
+**Nie otwieraj publicznych zgłoszeń dla podatności bezpieczeństwa.**
+
+Użyj prywatnego raportowania podatności GitHub:
+1. Przejdź do [zakładki Security](https://github.com/eviscerations/whisper-windows-mcp/security)
+2. Kliknij "Report a vulnerability"
+3. Opisz problem z wystarczającymi szczegółami do odtworzenia
+
+Otrzymasz odpowiedź w ciągu 7 dni. Jeśli podatność zostanie potwierdzona, poprawka zostanie wydana tak szybko, jak to możliwe, a ty zostaniesz wymieniony w notatkach wydania, jeśli sobie życzysz.
+
+## Znane decyzje projektowe
+
+- **Iniekcja ścieżki pliku:** Narzędzia akceptują bezwzględne ścieżki plików od Claude. Jest to celowy projekt — narzędzie jest przeznaczone do użytku z Claude Desktop przez właściciela komputera. Nie wystawiaj tego serwera MCP na niezaufany dostęp sieciowy.
+- **Brak piaskownicy:** whisper-cli.exe działa z tymi samymi uprawnieniami co Claude Desktop. Jest to standardowe dla lokalnych narzędzi MCP.
+- **Pliki tymczasowe:** Pośrednie pliki WAV są zapisywane w `%TEMP%\whisper_tmp_*.wav` i usuwane po transkrypcji. Pliki stanu zadań są zapisywane w `%TEMP%\whisper-mcp-jobs\` i pozostają do ręcznego wyczyszczenia lub do wydania planowanej funkcji automatycznego czyszczenia.
+- **Treść transkrypcji:** Tekst transkrypcji zwracany w odpowiedziach narzędzi jest przetwarzany przez API Claude. Jest to udokumentowane i będzie możliwe do rozwiązania przez `WHISPER_PRIVACY_MODE` w przyszłym wydaniu. Zobacz [PRIVACY.md](PRIVACY.md).

package/SECURITY.ro.md

@@ -0,0 +1,47 @@
+# Politică de securitate
+
+## Domeniu de aplicare
+
+whisper-windows-mcp este un instrument care prioritizează localul. Toată procesarea audio are loc pe calculatorul tău — niciun audio, fișier video sau date personale nu sunt transmise vreunui server. Suprafața de atac este limitată la:
+
+- Sistemul de fișiere local (căi de fișiere transmise instrumentelor)
+- Binarul whisper-cli.exe și dependențele sale
+- Conexiunea MCP Claude Desktop (doar IPC local)
+- Textul de transcriere returnat în răspunsurile instrumentelor (vezi Arhitectura de confidențialitate mai jos)
+
+## Arhitectura de confidențialitate
+
+**Fișierele audio nu părăsesc niciodată calculatorul tău.** Această garanție este necondiționată.
+
+**Textul de transcriere poate părăsi calculatorul tău.** Când un răspuns al instrumentului include text de transcriere, acel text este procesat de API-ul Claude. Acesta este comportamentul standard MCP, dar creează un decalaj între filosofia de proiectare "local prioritar" a instrumentului și fluxul real de date pentru utilizatorii care gestionează conținut reglementat sau confidențial.
+
+O variabilă de mediu `WHISPER_PRIVACY_MODE` este planificată care va restricționa toate răspunsurile instrumentelor doar la metadate — niciun text de transcriere nu este returnat la API-ul Claude. Aceasta este soluția prevăzută pentru implementările medicale, juridice, financiare și corporative.
+
+Vezi [PRIVACY.md](PRIVACY.md) pentru descrierea completă a arhitecturii de confidențialitate, îndrumări privind cadrele de conformitate (HIPAA, GDPR, privilegiu avocat-client, FERPA, SOX, PCI-DSS) și instrucțiuni de configurare.
+
+## Versiuni suportate
+
+Corecțiile de securitate sunt aplicate doar celei mai recente versiuni publicate.
+
+| Versiune | Suportată |
+|---|---|
+| 2.x (cea mai recentă) | ✅ |
+| 1.x | ❌ |
+
+## Raportarea unei vulnerabilități
+
+**Nu deschide un issue public pentru vulnerabilități de securitate.**
+
+Folosește raportarea privată a vulnerabilităților GitHub:
+1. Mergi la [fila Security](https://github.com/eviscerations/whisper-windows-mcp/security)
+2. Fă clic pe "Report a vulnerability"
+3. Descrie problema cu suficiente detalii pentru a o reproduce
+
+Vei primi un răspuns în 7 zile. Dacă vulnerabilitatea este confirmată, o corecție va fi lansată cât mai curând posibil și vei fi creditat în notele de lansare dacă dorești.
+
+## Decizii de proiectare cunoscute
+
+- **Injecție de cale de fișier:** Instrumentele acceptă căi absolute de fișiere de la Claude. Acesta este un design intenționat — instrumentul este destinat utilizării cu Claude Desktop de către proprietarul calculatorului. Nu expune acest server MCP la acces de rețea neautorizat.
+- **Fără sandbox:** whisper-cli.exe rulează cu aceleași permisiuni ca Claude Desktop. Acesta este standard pentru instrumentele MCP locale.
+- **Fișiere temporare:** Fișierele WAV intermediare sunt scrise în `%TEMP%\whisper_tmp_*.wav` și șterse după transcriere. Fișierele de stare a sarcinilor sunt scrise în `%TEMP%\whisper-mcp-jobs\` și persistă până la ștergerea manuală sau până la lansarea funcției de curățare automată planificate.
+- **Conținut de transcriere:** Textul de transcriere returnat în răspunsurile instrumentelor este procesat de API-ul Claude. Acesta este documentat și va putea fi adresat prin `WHISPER_PRIVACY_MODE` într-o versiune viitoare. Vezi [PRIVACY.md](PRIVACY.md).

package/TROUBLESHOOTING.pl.md

@@ -0,0 +1,323 @@
+# whisper-windows-mcp — Rozwiązywanie problemów
+
+---
+
+## Szybka lista kontrolna
+
+Przed głębszym śledztwem zweryfikuj wszystkie poniższe punkty:
+
+- Ścieżki w `claude_desktop_config.json` używają **podwójnych ukośników odwrotnych** (`C:\\whisper\\...`)
+- `whisper-cli.exe` istnieje pod ścieżką podaną w `WHISPER_CLI_PATH`
+- Plik modelu `.bin` istnieje pod ścieżką podaną w `WHISPER_MODEL`
+- FFmpeg jest zainstalowany i dostępny (`ffmpeg -version` działa w wierszu poleceń)
+- Claude Desktop został **w pełni uruchomiony ponownie** po edycji konfiguracji (wyjście z zasobnika systemowego, a nie tylko zamknięcie okna)
+- Serwer whisper wyświetla się jako **uruchomiony** (zielony znaczek) w Ustawieniach → Deweloper
+
+---
+
+## "whisper nie jest połączony" lub brak dostępnych narzędzi
+
+**Najczęstsza przyczyna:** Claude Desktop nie został w pełni uruchomiony ponownie po edycji konfiguracji.
+
+1. Kliknij prawym przyciskiem myszy ikonę Claude w zasobniku systemowym → Wyjdź
+2. Ponownie otwórz Claude Desktop
+3. Przejdź do Ustawień → Deweloper i sprawdź zielony znaczek **uruchomiony** obok whisper
+
+Jeśli nadal nie wyświetla się:
+
+1. Otwórz `claude_desktop_config.json` i sprawdź błędy składni JSON (brakujące przecinki, niezgodne nawiasy klamrowe)
+2. Upewnij się, że wszystkie ścieżki używają podwójnych ukośników odwrotnych
+3. Uruchom `check_config` w Claude Desktop, aby uzyskać diagnostykę
+
+---
+
+## download_model przekracza limit czasu dla dużych modeli
+
+Claude Desktop ma 4-minutowy limit czasu dla wywołań narzędzi MCP. Pobieranie dużych modeli przy wolnym połączeniu może go przekroczyć.
+
+**Rozmiary plików:**
+- `large-v3` — 2,9 GB
+- `large-v3-turbo` — 1,6 GB
+- `large-v3-q5_0` — 1,1 GB
+- `large-v3-turbo-q5_0` — 547 MB
+- `medium.en` — 1,5 GB
+- `medium.en-q5_0` — 514 MB
+
+Przy szybkim połączeniu (100 Mbps+) nawet large-v3 pobiera się w mniej niż 4 minuty. Przy wolniejszych połączeniach użyj przeglądarki lub PowerShell do bezpośredniego pobierania i umieść plik w katalogu modeli ręcznie:
+
+```powershell
+# Przykład — bezpośrednie pobieranie large-v3-turbo
+Invoke-WebRequest -Uri "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin" `
+  -OutFile "C:\whisper\models\ggml-large-v3-turbo.bin"
+```
+
+Następnie użyj `switch_model ggml-large-v3-turbo.bin` do aktywacji.
+
+---
+
+## `check_config` raportuje brak whisper-cli.exe
+
+Ścieżka w konfiguracji nie odpowiada rzeczywistej lokalizacji pliku.
+
+Zweryfikuj istnienie pliku:
+```
+dir C:\whisper\Release\whisper-cli.exe
+```
+
+Jeśli jest gdzie indziej, zaktualizuj `WHISPER_CLI_PATH` w konfiguracji, aby odpowiadał rzeczywistej ścieżce.
+
+---
+
+## `check_config` raportuje brak FFmpeg
+
+FFmpeg nie jest zainstalowany lub nie ma go w systemowym PATH.
+
+Instalacja przez winget:
+```
+winget install ffmpeg
+```
+
+Lub pobierz z [ffmpeg.org](https://ffmpeg.org/download.html), wypakuj i dodaj folder `bin` do systemowego PATH.
+
+Po instalacji otwórz nowy wiersz poleceń i zweryfikuj:
+```
+ffmpeg -version
+```
+
+Jeśli zainstalowałeś FFmpeg w niestandardowej lokalizacji, ustaw zmienną środowiskową `FFMPEG_PATH` w konfiguracji Claude Desktop:
+```json
+"env": {
+  "FFMPEG_PATH": "C:\\ffmpeg\\bin\\ffmpeg.exe"
+}
+```
+
+---
+
+## Wynik transkrypcji jest pełen tagów `[FOREIGN]`
+
+**Przyczyna:** Używasz modelu tylko angielskiego (np. `ggml-medium.en.bin`) na audio w innym języku niż angielski. Modele tylko angielskie nie mogą przetwarzać innych języków i wypisują `[FOREIGN]` jako placeholder dla każdego segmentu, którego nie mogą obsłużyć.
+
+**Rozwiązanie:** Pobierz i użyj `ggml-large-v3.bin` — modelu wielojęzycznego. Jest to wymagane do jakiejkolwiek transkrypcji innej niż angielska, automatycznego wykrywania języka lub tłumaczenia.
+
+```
+https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3.bin
+```
+
+Zapisz w `C:\whisper\models\` i zaktualizuj konfigurację:
+```json
+"WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin"
+```
+
+Lub zastąp dla każdej transkrypcji używając parametru `model` w `transcribe_audio` lub `generate_subtitles`.
+
+> **Uwaga:** Modele tylko angielskie (`*.en.bin`) są szybsze i dokładniejsze dla treści angielskich, ale całkowicie nie radzą sobie z innymi językami. Jeśli pracujesz z treściami wielojęzycznymi, `large-v3` jest właściwym modelem niezależnie od sprzętu.
+
+---
+
+## Transkrypcja nie produkuje wyników lub pusty plik
+
+**Możliwe przyczyny:**
+
+1. **Zły model dla języka** — Modele tylko angielskie (`*.en.bin`) nie mogą transkrybować innych języków. Używaj `ggml-large-v3.bin` dla treści wielojęzycznych.
+
+2. **Zbyt niska jakość audio** — Pliki o bardzo niskiej przepływności (np. stare nagrania telefoniczne `.3gp` używające kodeka AMR-NB ~12kbps) mogą być na granicy możliwości whispera. Hałaśliwe środowiska (hałas w tle, echo, odlegli mówcy) są również trudne. Spróbuj `large-v3`, który lepiej radzi sobie z degradowanym audio.
+
+3. **Plik jest cichy lub uszkodzony** — Uruchom `analyze_media` na pliku, aby sprawdzić czy FFprobe wykrywa prawidłowy strumień audio.
+
+4. **Błąd konwersji** — Plik może nie konwertować się do WAV poprawnie. Spróbuj najpierw ręcznie przekonwertować:
+```
+ffmpeg -i yourfile.3gp -ar 16000 -ac 1 output.wav
+```
+Następnie transkrybuj WAV bezpośrednio.
+
+---
+
+## Zadanie w tle nie działa dla plików ze znakami specjalnymi lub Unicode w nazwie
+
+**Przyczyna:** whisper-cli.exe nie może zapisać pliku wyjściowego gdy ścieżka zawiera znaki Unicode (polskie, japońskie, chińskie, emoji, nawiasy itp.) lub niektóre znaki specjalne.
+
+**Aktualne obejście:** Zmień nazwę pliku, aby używał tylko znaków ASCII przed transkrypcją, a następnie zmień nazwę z powrotem jeśli to konieczne.
+
+```
+ren "plik_po_polsku.mp4" "temp_transcribe.mp4"
+```
+
+**Status:** Jest to znany błąd. Planowana jest poprawka, która będzie kierować wyjście przez oczyszczoną tymczasową ścieżkę i przenosić wynik do właściwego miejsca docelowego po zakończeniu.
+
+---
+
+## Zadanie w tle pokazuje "błąd" bez wyników
+
+**Możliwe przyczyny:**
+
+1. **Nazwa pliku Unicode** — Patrz wyżej.
+
+2. **Zła ścieżka modelu** — Odłączony proces nie dziedziczy poprawionych ścieżek. Uruchom `check_config`, aby zweryfikować ścieżki.
+
+3. **Proces został zakończony** — Jeśli whisper-cli.exe został ręcznie zakończony w trakcie zadania, plik wyjściowy nie będzie istniał. Spróbuj ponownie.
+
+4. **Niewystarczająca VRAM** — Duże modele na GPU z małą VRAM mogą po cichu kończyć się błędem. Spróbuj mniejszego modelu.
+
+5. **Błąd konwersji pliku** — Spróbuj transkrybować plik WAV bezpośrednio, aby ustalić czy problem leży w konwersji czy transkrypcji.
+
+---
+
+## Transkrypcja w tle nie produkuje wyników SRT
+
+**Przyczyna:** Tryb w tle (`background=true` w `transcribe_audio`) obecnie produkuje tylko wyjście `.txt`. Format SRT w trybie w tle nie jest jeszcze zaimplementowany.
+
+**Obejście:** Dla plików poniżej ~4 minut użyj `generate_subtitles` w trybie blokującym. Dla dłuższych plików najpierw transkrybuj w trybie w tle, aby uzyskać `.txt`, następnie jeśli potrzebujesz SRT użyj `generate_subtitles` na tym samym pliku (będzie transkrybować ponownie).
+
+**Status:** Obsługa SRT w trybie w tle jest planowana na przyszłe wydanie.
+
+---
+
+## GPU nie jest używany (CPU zablokowany powyżej 50%)
+
+**Przyczyna:** Uruchamiasz binarium tylko CPU, które jest dostarczane ze standardowym wydaniem whisper.cpp.
+
+**Rozwiązanie:** Pobierz kompilację z włączonym Vulkan ze [strony wydań](https://github.com/eviscerations/whisper-windows-mcp/releases/tag/v1.4.0) i wypakuj do `C:\whisper\Release\`.
+
+Zweryfikuj, czy akceleracja GPU jest aktywna:
+- Poproś Claude o uruchomienie `check_system`
+- Szukaj `✅ Vulkan binary: ggml-vulkan.dll found` w wynikach
+- Obserwuj Menedżer zadań → Wydajność → GPU podczas transkrypcji — wykorzystanie GPU powinno wzrosnąć do 15–30%
+
+---
+
+## `check_system` raportuje błędną ilość VRAM
+
+Jest to znane ograniczenie Windows. Polecenie `wmic` odczytuje VRAM z rejestru, który na wielu kartach AMD raportuje połowę fizycznej VRAM. Vega 56 z 8GB HBM2 zazwyczaj będzie pokazywać 4GB. Jest to tylko problem wyświetlania — whisper używa pełnej fizycznej VRAM podczas wnioskowania.
+
+---
+
+## Błąd "Transkrypcja już w toku"
+
+Proces `whisper-cli.exe` działa z poprzedniego zadania. Poczekaj na jego zakończenie lub:
+
+1. Otwórz Menedżer zadań → zakładka Szczegóły
+2. Znajdź `whisper-cli.exe`
+3. Kliknij prawym przyciskiem myszy → Zakończ zadanie
+
+Następnie spróbuj ponownie.
+
+---
+
+## Automatyczne wykrywanie języka jest błędne
+
+Automatyczne wykrywanie Whisper działa na pierwszych 30 sekundach audio. Jeśli plik zaczyna się w innym języku niż większość jego zawartości, wykrywanie może być błędne.
+
+**Rozwiązanie:** Podaj język jawnie (np. `language=pl`) zamiast polegać na automatycznym wykrywaniu.
+
+---
+
+## Generowanie napisów produkuje "(mówi w obcym języku)" przez cały film
+
+Whisper wykrył mowę, ale nie mógł transkrybować. Najczęstsze przyczyny:
+
+1. **Zły model** — Używanie modelu tylko angielskiego na audio w innym języku. Użyj `large-v3`.
+
+2. **Jakość audio** — Hałaśliwe środowiska (kuchnie, tłumy, echo) mogą pokonać model medium. Spróbuj `large-v3`.
+
+3. **Mieszane języki** — Pliki z dwoma językami naprzemiennie będą miały mniejszościowy język zastąpiony placeholderami przy ustawieniu jednego języka.
+
+---
+
+## Tłumaczenie napisów produkuje tylko angielski
+
+Jest to zamierzone zachowanie. Wbudowana flaga `--translate` Whisper tłumaczy tylko **na angielski**. Dla tłumaczenia na inne języki docelowe przetwórz zawartość pliku `.srt` osobno.
+
+---
+
+## Wsadowa transkrypcja przestała się posuwać
+
+Wywołaj ponownie `check_batch_progress`. Jeśli nadal utknęła:
+
+1. Sprawdź Menedżer zadań pod kątem działającego procesu `whisper-cli.exe`
+2. Sprawdź logi zadań w `%TEMP%\whisper-mcp-jobs\`
+3. Pliki z błędami są oznaczone w raporcie partii — uruchom je indywidualnie przez `transcribe_audio`
+
+---
+
+## Czyszczenie tymczasowego katalogu zadań
+
+whisper-windows-mcp zapisuje pliki stanu zadań i logi w `%TEMP%\whisper-mcp-jobs\` podczas transkrypcji. Gromadzą się one z czasem i mogą zużywać miejsce na dysku, szczególnie pliki `.log` z długich zadań transkrypcji.
+
+Po zakończeniu partii lub zadania i zweryfikowaniu transkrypcji wyjściowych możesz bezpiecznie usunąć wszystko w tym katalogu:
+
+```powershell
+Remove-Item "$env:TEMP\whisper-mcp-jobs\*" -Recurse -Force
+```
+
+Katalog zostanie automatycznie odtworzony przy następnej transkrypcji. Żadne pliki wyjściowe transkrypcji nie są tu przechowywane na stałe — są przenoszone do katalogu źródłowego po zakończeniu. Pozostają tylko metadane zadań i logi.
+
+**Uwaga:** Nie usuwaj tego katalogu podczas trwającej transkrypcji — pliki stanu partii są potrzebne do działania `check_batch_progress`.
+
+---
+
+## Duża nienadzorowana partia z wiersza poleceń
+
+Dla bardzo dużych partii, gdzie chcesz uruchomić przez noc bez Claude, użyj PowerShell.
+
+**Ważne:** whisper-cli.exe nie może bezpośrednio odczytywać MP4, MKV ani większości formatów wideo. FFmpeg musi wcześniej przekonwertować każdy plik do WAV. Whisper zapisuje również transkrypcję do stdout, a dane diagnostyczne do stderr — użyj `Start-Process -RedirectStandardOutput`, aby poprawnie przechwycić transkrypcję. Używanie pipe `|` lub przekierowywanie stderr przez `2>$null` nic nie przechwytuje.
+
+```powershell
+$whisper = "C:\whisper\Release\whisper-cli.exe"
+$model   = "C:\whisper\models\ggml-medium.en.bin"
+$dir     = "C:\path\to\your\folder"
+$ffmpeg  = "ffmpeg"
+$tmp     = "$env:TEMP\whisper_convert.wav"
+
+Get-ChildItem "$dir\*.mp4" | ForEach-Object {
+    $out = ($_.FullName -replace '\.mp4$', '') + ".txt"
+    if (Test-Path $out) {
+        Write-Host "SKIP (exists): $($_.Name)"
+        return
+    }
+    Write-Host "Converting:    $($_.Name)"
+    & $ffmpeg -y -i $_.FullName -ar 16000 -ac 1 -c:a pcm_s16le $tmp 2>$null
+    Write-Host "Transcribing:  $($_.Name)"
+    $wArgs = "-m `"$model`" -f `"$tmp`" --threads 8 --condition-on-previous-text 0 --no-speech-thold 0.6"
+    Start-Process -FilePath $whisper -ArgumentList $wArgs -RedirectStandardOutput $out -Wait -NoNewWindow
+    Write-Host "Done:          $($_.BaseName).txt"
+}
+
+Remove-Item $tmp -ErrorAction SilentlyContinue
+Write-Host "All done."
+```
+
+Zmień `*.mp4` na `*.mkv`, `*.m4a` itp., aby dopasować do typów plików. Sprawdzenie pominięcia `Test-Path` oznacza, że ponowne uruchomienie skryptu po przerwaniu nie będzie ponownie przetwarzać już ukończonych plików.
+
+Skrypt zapisuje pliki `.txt` obok każdego źródła. Narzędzia MCP rozpoznają je jako już transkrybowane po uruchomieniu `analyze_media` lub `start_batch`.
+
+---
+
+## Lokalizacja pliku konfiguracyjnego
+
+```
+C:\Users\NazwaUżytkownika\AppData\Roaming\Claude\claude_desktop_config.json
+```
+
+Jeśli `AppData` nie jest widoczne: Widok → Pokaż → Ukryte elementy w Eksploratorze plików.
+
+---
+
+## Pełny przykład działającej konfiguracji
+
+```json
+{
+  "mcpServers": {
+    "whisper": {
+      "command": "npx",
+      "args": ["-y", "whisper-windows-mcp"],
+      "env": {
+        "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
+        "WHISPER_MODEL": "C:\\whisper\\models\\ggml-medium.en.bin",
+        "FFMPEG_PATH": "ffmpeg"
+      }
+    }
+  }
+}
+```
+
+`FFMPEG_PATH` domyślnie przyjmuje wartość `ffmpeg` (zakłada obecność w PATH). Ustaw jawnie tylko jeśli FFmpeg jest zainstalowany w niestandardowej lokalizacji.