whisper-windows-mcp 1.4.0 → 1.4.2

package/package.json

@@ -1,38 +1,38 @@
-{
-  "name": "whisper-windows-mcp",
-  "version": "1.4.0",
-  "description": "Windows-native MCP server for local audio transcription using whisper.cpp with Vulkan GPU acceleration",
-  "main": "dist/index.js",
-  "bin": {
-    "whisper-windows-mcp": "dist/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js"
-  },
-  "keywords": [
-    "mcp",
-    "whisper",
-    "windows",
-    "transcription",
-    "speech-to-text",
-    "audio",
-    "claude",
-    "model-context-protocol",
-    "whisper-cpp",
-    "vulkan",
-    "gpu"
-  ],
-  "author": "eviscerations",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.0.0",
-    "@types/node": "^20.0.0"
-  },
-  "engines": {
-    "node": ">=18"
-  }
-}
+{
+  "name": "whisper-windows-mcp",
+  "version": "1.4.2",
+  "description": "Windows-native MCP server for local audio transcription using whisper.cpp with Vulkan GPU acceleration",
+  "main": "dist/index.js",
+  "bin": {
+    "whisper-windows-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "whisper",
+    "windows",
+    "transcription",
+    "speech-to-text",
+    "audio",
+    "claude",
+    "model-context-protocol",
+    "whisper-cpp",
+    "vulkan",
+    "gpu"
+  ],
+  "author": "eviscerations",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/FUNDING.yml

@@ -1,3 +0,0 @@
-github: eviscerations
-ko_fi: 
-patreon: 

package/ROADMAP.md

@@ -1,129 +0,0 @@
-# whisper-windows-mcp — Roadmap
-
-Current version is v1.4.0. GPU acceleration via Vulkan is now working. This document tracks what has been completed and what remains.
-
----
-
-## Completed
-
-### ✅ Priority 1 — GPU Acceleration (v1.4.0)
-
-Compiled whisper.cpp from source with `-DGGML_VULKAN=ON` using Visual Studio Build Tools 2026 and Vulkan SDK 1.4.341.1. Pre-built Vulkan binaries are now distributed as a release asset (`whisper-vulkan-win-x64.zip`).
-
-**Results:** AMD Radeon RX Vega 56 at ~16% GPU utilization, 1.2GB VRAM, CPU at ~15% during transcription. A ~5 minute file that previously took 8–12 minutes on CPU now completes in 20–40 seconds.
-
-The official whisper.cpp Windows releases do not include a Vulkan build ([issue #3673](https://github.com/ggml-org/whisper.cpp/issues/3673)). The pre-built release in this repo fills that gap for AMD and Intel GPU users.
-
-### ✅ Priority 2 — Process Lock (v1.3.1)
-
-Added `isWhisperRunning()` check using `tasklist /FI` before any transcription spawn. If `whisper-cli.exe` is already running, returns a clear error with Task Manager instructions rather than spawning a second competing process.
-
----
-
-## Known Issues (Remaining)
-
-### 3. 4-Minute Claude MCP Timeout
-The Claude web client cuts MCP connections after ~4 minutes. Whisper continues running in the background after the timeout fires, but Claude can't confirm completion. With GPU acceleration this is less frequently hit, but still a concern for very long files or large models.
-
-### 5. No Progress Visibility
-The user has no indicator that transcription is happening or how far along it is. whisper-cli.exe outputs segment timestamps to stderr as it processes — the MCP should pipe and expose these.
-
-### 6. Background Batch Non-Functional
-A background batch mode was attempted in a previous version but stripped due to no visible feedback. Needs a proper detached process architecture with job state files.
-
-### 7. No File Pre-Analysis
-No way to know file duration or size before processing starts.
-
----
-
-## Roadmap
-
-### Priority 3 — File Pre-Analysis Tool
-
-New tool `analyze_media` using FFprobe:
-
-```
-ffprobe -v quiet -print_format json -show_format -show_streams <file>
-```
-
-Returns: duration, file size, codec, bitrate, estimated transcription time (CPU and GPU).
-
----
-
-### Priority 4 — Progress Visibility
-
-whisper-cli.exe outputs segment timestamps to stderr (e.g. `[00:01:30 --> 00:01:35]`). The MCP should:
-
-1. Pipe stderr to a log file during processing
-2. Expose a `check_progress` tool returning last timestamp, percentage complete, estimated time remaining, and whether the process is still running
-
----
-
-### Priority 5 — Timeout Workaround (Detached Process Architecture)
-
-Rearchitect transcription to use fully detached background processes:
-
-1. `transcribe_audio` → spawn whisper as detached process → write `job.json` → return immediately with job ID
-2. `check_progress` → read `job.json` → check PID → read log → return status + percentage
-3. When complete → read and return transcript
-
-This eliminates the 4-minute timeout problem entirely and unlocks Priority 6.
-
----
-
-### Priority 6 — Sequential Batch with Validation
-
-Rebuild batch mode on top of Priority 5:
-
-1. `transcribe_batch` → runs `analyze_media` on folder → sorts by duration → processes one file at a time using detached process
-2. After each file: validate .txt exists, is non-empty, line count proportional to duration
-3. Flag suspect outputs for re-run
-4. `check_batch_progress` returns: files done, remaining, current file, ETA, any failed files
-
----
-
-### Priority 7 — Multi-Language Support and Translation
-
-Expose `--language` and `--translate` flags properly:
-
-- `language` parameter: auto-detect (default) or specify (`ja`, `es`, `de`, etc.)
-- `translate_to_english`: boolean — uses whisper's built-in translation model
-- Dual output: two whisper passes, two output files
-
----
-
-### Priority 8 — Filename-Based References Throughout
-
-All tool outputs must reference the full source filename at all times. Never use positional indices as the primary identifier.
-
----
-
-### Priority 9 — System Diagnostics Tool
-
-New tool `check_system`:
-
-- GPU vendor and model (via `wmic path win32_VideoController`)
-- Whether `ggml-vulkan.dll` is present alongside `whisper-cli.exe`
-- Recommended model size for available VRAM
-- Estimated throughput based on hardware profile
-- Actionable guidance if GPU binary is missing
-
----
-
-## Design Principles
-
-**Minimize Claude API usage.** The entire transcription workflow should require fewer than 20 Claude interactions for a 60-file batch.
-
-**One whisper instance at all times.** Never spawn a second process while one is running.
-
-**Local-first, private by default.** No audio leaves the machine. No cloud APIs required.
-
-**Works for free-tier users.** Courtroom transcription, documentary research, foreign film subtitling — the tool should serve people who can't afford cloud transcription services.
-
----
-
-## Contributing
-
-Pull requests welcome for any of the above priorities. Check existing issues before starting work.
-
-If you've tested GPU acceleration on hardware not listed above, please open an issue with your results — GPU model, VRAM, model size, and observed throughput.

package/TROUBLESHOOTING.md

@@ -1,172 +0,0 @@
-# Troubleshooting
-
-This document covers common issues and their solutions, including workarounds for known limitations.
-
----
-
-## "whisper-cli not found" error
-
-**Symptom:** Claude reports `whisper-cli not found` or suggests running `brew install whisper-cpp`.
-
-The `brew install` suggestion is a macOS instruction and does not apply to Windows. This error means the MCP server cannot locate `whisper-cli.exe`.
-
-**Fix:** Make sure `WHISPER_CLI_PATH` in your `claude_desktop_config.json` points to the exact location of `whisper-cli.exe`, using double backslashes:
-
-```json
-"WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe"
-```
-
-Verify the file exists by navigating to it in File Explorer.
-
----
-
-## "File not found" when transcribing
-
-1. **Wrong path format** — when typing paths directly in Claude chat, use normal single backslashes: `C:\Users\Me\Downloads\audio.mp3`
-2. **File doesn't exist** — double-check in File Explorer
-3. **Spaces in path** — paths with spaces work fine, just make sure you give Claude the complete path
-
----
-
-## Video files fail with FFmpeg error
-
-**Symptom:** Transcribing an MP4 or other video file fails with an FFmpeg-related error.
-
-**Fix:** Make sure FFmpeg is installed and in your system PATH.
-
-1. Download FFmpeg from [ffmpeg.org/download.html](https://ffmpeg.org/download.html)
-2. Extract and note the location of `ffmpeg.exe` (usually in a `bin` subfolder)
-3. Add that folder to your system PATH:
-   - **Win + S** → search **Environment Variables** → open it
-   - Under **User Variables**, select **Path** → **Edit** → **New**
-   - Add the path to the folder containing `ffmpeg.exe`
-   - Click OK on all dialogs, then restart Claude Desktop
-
-✅ Verify FFmpeg is working: open Command Prompt and run `ffmpeg -version`
-
-Alternatively, add `FFMPEG_PATH` to your config pointing directly to `ffmpeg.exe`:
-```json
-"FFMPEG_PATH": "C:\\ffmpeg\\bin\\ffmpeg.exe"
-```
-
----
-
-## Whisper server shows as "error" in Settings → Developer
-
-1. Make sure your `claude_desktop_config.json` is valid JSON — a missing comma or bracket breaks it. Paste it into [jsonlint.com](https://jsonlint.com) to check.
-2. Make sure Node.js is installed: open Command Prompt and run `node --version`
-3. Fully quit Claude Desktop (check Task Manager for any remaining Claude processes) and reopen it
-
----
-
-## Transcription runs but produces garbled text
-
-- **Wrong language:** Specify the language when asking Claude — *"Transcribe this in English"* or add `"language": "en"` in the call
-- **Poor audio quality:** Whisper handles most accents well but very low bitrate or heavily distorted audio will reduce accuracy
-- **Try a larger model:** `medium.en` is significantly more accurate than `base.en`, at the cost of speed
-
----
-
-## Transcription is very slow
-
-This is expected on CPU. Rough estimates for a 1-hour file:
-
-| Model | Time |
-|---|---|
-| base.en | 10–20 min |
-| medium.en | 35–60 min |
-
-To speed up, increase the thread count by adding to your config:
-```json
-"WHISPER_THREADS": "12"
-```
-
-Use up to the number of logical cores your CPU has (check Task Manager → Performance → CPU for your core count).
-
----
-
-## Cancelling a long transcription
-
-**Known limitation:** Clicking the stop/cancel button in Claude Desktop while a transcription is running will return control to Claude but does NOT stop the underlying whisper-cli process. It continues running in the background consuming CPU.
-
-**To actually stop it:**
-1. Open Task Manager (Ctrl + Shift + Esc)
-2. Go to the **Details** tab
-3. Find `whisper-cli.exe` and right-click → **End Process Tree**
-
----
-
-## Running large overnight batch jobs (unattended)
-
-**Known limitation:** Claude Desktop has a connection timeout that prevents long-running batch operations through the MCP server. For large unattended batch jobs (many files, or long recordings), use whisper-cli directly from the command line instead.
-
-**Single file from command line:**
-```
-"C:\whisper\Release\whisper-cli.exe" -m "C:\whisper\models\ggml-medium.en.bin" -f "C:\path\to\audio.mp3" --no-timestamps -t 8 > "C:\path\to\output.txt"
-```
-
-**Batch folder using PowerShell (run from PowerShell window):**
-```powershell
-$folder = "C:\path\to\your\folder"
-$whisper = "C:\whisper\Release\whisper-cli.exe"
-$model = "C:\whisper\models\ggml-medium.en.bin"
-
-Get-ChildItem $folder -Include *.mp4,*.mp3,*.mkv,*.wav -Recurse | ForEach-Object {
-    $out = $_.FullName -replace '\.[^.]+$', '.txt'
-    Write-Host "Processing: $($_.Name)"
-    & $whisper -m $model -f $_.FullName --no-timestamps -t 8 | Out-File -FilePath $out -Encoding utf8
-    Write-Host "Done: $out"
-}
-Write-Host "Batch complete."
-```
-
-Save this as a `.ps1` file and run it from PowerShell, or paste it directly into a PowerShell window. You can let it run overnight — it will process each file sequentially and save a `.txt` next to each source file.
-
-> **Note:** If PowerShell blocks the script with an execution policy error, run: `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`
-
----
-
-## Claude Desktop fails to install or update (HRESULT errors)
-
-This is a Windows MSIX packaging issue, not related to this MCP server. Steps to resolve:
-
-1. Fully uninstall Claude Desktop via **Settings → Apps → Apps & features**
-2. Open Task Manager and end any remaining Claude or Cowork processes
-3. Delete `C:\Users\YourUsername\AppData\Local\AnthropicClaude` if it exists
-4. **Restart your computer** — some package registrations persist in memory until reboot
-5. Run the installer again after reboot
-
----
-
-## Double backslashes in JSON — why?
-
-In JSON, the backslash `\` is an escape character. To represent a literal backslash (as used in Windows paths), you must write `\\`. So:
-
-| Windows path | In JSON config |
-|---|---|
-| `C:\whisper\Release\whisper-cli.exe` | `"C:\\whisper\\Release\\whisper-cli.exe"` |
-
-This only applies inside the JSON config file. When typing paths into Claude in the chat, use normal single backslashes.
-
----
-
-## Config file location
-
-```
-C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json
-```
-
-The `AppData` folder is hidden by default. To show hidden folders: File Explorer → **View → Show → Hidden items**.
-
-You can also reach the config via Claude Desktop → **Settings → Developer → Edit Config**.
-
----
-
-## Still stuck?
-
-Open an issue at [github.com/eviscerations/whisper-windows-mcp/issues](https://github.com/eviscerations/whisper-windows-mcp/issues) and include:
-
-- Your Windows version
-- Your `claude_desktop_config.json` (remove personal info)
-- The MCP server log from **Settings → Developer → View Logs**
-- What you've already tried

package/src/index.ts

@@ -1,446 +0,0 @@
-#!/usr/bin/env node
-/**
- * whisper-windows-mcp
- * A Windows-native MCP server for local audio transcription using whisper.cpp
- * https://github.com/eviscerations/whisper-windows-mcp
- */
-
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-} from "@modelcontextprotocol/sdk/types.js";
-import { execFile } from "child_process";
-import {
-  existsSync, unlinkSync, readdirSync,
-  writeFileSync, readFileSync
-} from "fs";
-import { cpus, tmpdir } from "os";
-import { join, extname, basename } from "path";
-import { promisify } from "util";
-
-const execFileAsync = promisify(execFile);
-
-// ---------------------------------------------------------------------------
-// Configuration
-// ---------------------------------------------------------------------------
-const WHISPER_CLI_PATH =
-  process.env.WHISPER_CLI_PATH ?? "C:\\whisper\\Release\\whisper-cli.exe";
-const WHISPER_MODEL =
-  process.env.WHISPER_MODEL ?? "C:\\whisper\\models\\ggml-base.en.bin";
-const FFMPEG_PATH =
-  process.env.FFMPEG_PATH ?? "ffmpeg";
-
-const SYSTEM_THREADS = cpus().length;
-const DEFAULT_THREADS = Math.max(2, Math.floor(SYSTEM_THREADS / 2));
-const WHISPER_THREADS = parseInt(process.env.WHISPER_THREADS ?? String(DEFAULT_THREADS), 10);
-
-const SUPPORTED_EXTENSIONS = [
-  ".mp3", ".wav",
-  ".mp4", ".mkv", ".avi", ".mov", ".webm", ".flv", ".wmv", ".m4v",
-  ".m4a", ".ogg", ".flac",
-];
-const NATIVE_EXTENSIONS = [".mp3", ".wav"];
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-function validatePaths(): string | null {
-  if (!existsSync(WHISPER_CLI_PATH))
-    return `whisper-cli.exe not found at: ${WHISPER_CLI_PATH}\nCheck WHISPER_CLI_PATH in claude_desktop_config.json`;
-  if (!existsSync(WHISPER_MODEL))
-    return `Whisper model not found at: ${WHISPER_MODEL}\nCheck WHISPER_MODEL in claude_desktop_config.json`;
-  return null;
-}
-
-/**
- * Check whether a whisper-cli.exe process is already running.
- * Uses tasklist /FI which is available on all Windows versions.
- * Returns true if found, false if not (or if tasklist itself fails).
- */
-async function isWhisperRunning(): Promise<boolean> {
-  try {
-    const { stdout } = await execFileAsync(
-      "tasklist",
-      ["/FI", "IMAGENAME eq whisper-cli.exe", "/NH"],
-      { windowsHide: true }
-    );
-    return stdout.toLowerCase().includes("whisper-cli.exe");
-  } catch {
-    // If tasklist fails for any reason, assume safe to proceed
-    return false;
-  }
-}
-
-function needsConversion(filePath: string): boolean {
-  return !NATIVE_EXTENSIONS.includes(extname(filePath).toLowerCase());
-}
-
-function isSupportedFile(filePath: string): boolean {
-  return SUPPORTED_EXTENSIONS.includes(extname(filePath).toLowerCase());
-}
-
-async function convertToWav(inputPath: string): Promise<string> {
-  const tmpFile = join(tmpdir(), `whisper_tmp_${Date.now()}.wav`);
-  await execFileAsync(FFMPEG_PATH, [
-    "-y", "-i", inputPath,
-    "-ar", "16000", "-ac", "1", "-c:a", "pcm_s16le", tmpFile,
-  ], { windowsHide: true });
-  return tmpFile;
-}
-
-type OutputFormat = "text" | "timestamps" | "json" | "srt";
-
-function buildArgs(
-  filePath: string, model: string, language: string,
-  outputFormat: OutputFormat, threads: number
-): string[] {
-  const args = ["-m", model, "-f", filePath, "-l", language, "-t", String(threads)];
-  if (outputFormat === "srt") {
-    args.push("-osrt", "-of", filePath.replace(/\.[^.]+$/, ""));
-  } else if (outputFormat === "json") {
-    args.push("-oj");
-  } else if (outputFormat === "text") {
-    args.push("--no-timestamps");
-  }
-  return args;
-}
-
-async function transcribeSingle(
-  filePath: string, model: string, language: string,
-  outputFormat: OutputFormat, threads: number, saveToFile = false
-): Promise<{ text: string; srtPath?: string; savedTo?: string }> {
-
-  // ---- Priority 2: Process lock ----
-  // Never spawn a second whisper-cli.exe while one is already running.
-  if (await isWhisperRunning()) {
-    throw new Error(
-      "Transcription already in progress.\n\n" +
-      "whisper-cli.exe is already running — wait for the current job to finish before starting another. " +
-      "If you believe this is wrong (e.g. a previous job crashed and left a stale process), " +
-      "open Task Manager, find whisper-cli.exe under Details, and end the task."
-    );
-  }
-
-  let transcribeFrom = filePath;
-  let tmpFile: string | null = null;
-
-  if (needsConversion(filePath)) {
-    tmpFile = await convertToWav(filePath);
-    transcribeFrom = tmpFile;
-  }
-
-  try {
-    const cliArgs = buildArgs(transcribeFrom, model, language, outputFormat, threads);
-    const { stdout, stderr } = await execFileAsync(WHISPER_CLI_PATH, cliArgs, {
-      maxBuffer: 100 * 1024 * 1024,
-      windowsHide: true,
-    });
-
-    const output = (stdout || stderr || "").trim();
-
-    if (outputFormat === "srt") {
-      const tmpSrt = transcribeFrom.replace(/\.[^.]+$/, ".srt");
-      const destSrt = filePath.replace(/\.[^.]+$/, ".srt");
-      if (tmpFile && existsSync(tmpSrt)) {
-        writeFileSync(destSrt, readFileSync(tmpSrt, "utf8"));
-        try { unlinkSync(tmpSrt); } catch { }
-      }
-      return { text: output, srtPath: destSrt };
-    }
-
-    if (saveToFile) {
-      const txtPath = filePath.replace(/\.[^.]+$/, ".txt");
-      writeFileSync(txtPath, output, "utf8");
-      return { text: output, savedTo: txtPath };
-    }
-
-    return { text: output };
-  } finally {
-    if (tmpFile && existsSync(tmpFile)) try { unlinkSync(tmpFile); } catch { }
-  }
-}
-
-function getFiles(dir: string, recursive: boolean): string[] {
-  const entries = readdirSync(dir, { withFileTypes: true });
-  const files: string[] = [];
-  for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
-    if (entry.isDirectory() && recursive) files.push(...getFiles(fullPath, true));
-    else if (entry.isFile() && isSupportedFile(entry.name)) files.push(fullPath);
-  }
-  return files;
-}
-
-// ---------------------------------------------------------------------------
-// MCP Server
-// ---------------------------------------------------------------------------
-const server = new Server(
-  { name: "whisper-windows-mcp", version: "1.4.0" },
-  { capabilities: { tools: {} } }
-);
-
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: [
-    {
-      name: "transcribe_audio",
-      description:
-        "Transcribe a single audio or video file using whisper.cpp on Windows. " +
-        "Natively supports mp3 and wav. Automatically converts mp4, mkv, avi, mov, " +
-        "webm, m4a, flac, ogg etc. via FFmpeg — no manual conversion needed. " +
-        "Can output plain text, timestamps, JSON, or SRT subtitle files. " +
-        "WARNING: files over 30 minutes cannot be cancelled cleanly from Claude — " +
-        "use Task Manager to kill the process if needed.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          file_path: { type: "string", description: "Absolute Windows path, e.g. C:\\Users\\You\\Downloads\\recording.mp4" },
-          model: { type: "string", description: "Override model path. Leave blank to use WHISPER_MODEL." },
-          language: { type: "string", description: "Language code, e.g. en, es, fr. Defaults to en.", default: "en" },
-          output_format: {
-            type: "string", enum: ["text", "timestamps", "json", "srt"],
-            description: "text = plain (default), timestamps = with time codes, json = structured, srt = subtitle file saved next to source.",
-            default: "text",
-          },
-          threads: { type: "number", description: `CPU threads. Defaults to ${WHISPER_THREADS} of ${SYSTEM_THREADS}.` },
-          save_to_file: { type: "boolean", description: "Save transcript as .txt next to the source file.", default: false },
-        },
-        required: ["file_path"],
-      },
-    },
-    {
-      name: "transcribe_batch",
-      description:
-        "Transcribe multiple audio/video files in a folder interactively, one file at a time. " +
-        "Shows a preview of each transcript and waits for confirmation before continuing. " +
-        "Saves each transcript as a .txt file next to its source. " +
-        "Files already transcribed (with matching .txt) are shown as done and skipped. " +
-        "Supported formats: mp3, wav, mp4, mkv, avi, mov, webm, m4a, flac, ogg. " +
-        "NOTE: For large unattended batch jobs, use whisper-cli.exe directly from the command line " +
-        "— see TROUBLESHOOTING.md for the command syntax.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          folder_path: { type: "string", description: "Absolute Windows path to the folder." },
-          file_index: {
-            type: "number",
-            description: "Which file to process (1-based). Omit to list files first.",
-          },
-          language: { type: "string", description: "Language code. Defaults to en.", default: "en" },
-          threads: { type: "number", description: `CPU threads. Defaults to ${WHISPER_THREADS} of ${SYSTEM_THREADS}.` },
-          recursive: { type: "boolean", description: "Include subfolders. Defaults to false.", default: false },
-        },
-        required: ["folder_path"],
-      },
-    },
-    {
-      name: "generate_subtitles",
-      description:
-        "Generate an SRT subtitle file for an audio or video file. " +
-        "Saved next to the source file. Load in VLC via Subtitle → Add Subtitle File. " +
-        "Supports all the same formats as transcribe_audio.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          file_path: { type: "string", description: "Absolute Windows path to the file." },
-          language: { type: "string", description: "Language code. Defaults to en.", default: "en" },
-          threads: { type: "number", description: `CPU threads. Defaults to ${WHISPER_THREADS} of ${SYSTEM_THREADS}.` },
-        },
-        required: ["file_path"],
-      },
-    },
-    {
-      name: "check_config",
-      description: "Verify whisper-cli.exe, model, and FFmpeg are all available. Run this first if anything fails.",
-      inputSchema: { type: "object", properties: {} },
-    },
-  ],
-}));
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-
-  // -------------------------------------------------------------------------
-  // check_config
-  // -------------------------------------------------------------------------
-  if (name === "check_config") {
-    const error = validatePaths();
-    if (error) return { content: [{ type: "text", text: `❌ Configuration error:\n\n${error}` }], isError: true };
-
-    let ffmpegStatus = "✅ Found";
-    try { await execFileAsync(FFMPEG_PATH, ["-version"], { windowsHide: true }); }
-    catch { ffmpegStatus = "⚠️  Not found — video/non-MP3 formats require FFmpeg in PATH"; }
-
-    return {
-      content: [{
-        type: "text",
-        text:
-          `✅ Configuration looks good!\n\n` +
-          `whisper-cli: ${WHISPER_CLI_PATH}\n` +
-          `Model:       ${WHISPER_MODEL}\n` +
-          `Threads:     ${WHISPER_THREADS} of ${SYSTEM_THREADS} logical cores\n` +
-          `FFmpeg:      ${ffmpegStatus}\n\n` +
-          `Optional env vars: WHISPER_THREADS, FFMPEG_PATH`,
-      }],
-    };
-  }
-
-  // -------------------------------------------------------------------------
-  // transcribe_audio
-  // -------------------------------------------------------------------------
-  if (name === "transcribe_audio") {
-    const filePath = args?.file_path as string;
-    const model = (args?.model as string) || WHISPER_MODEL;
-    const language = (args?.language as string) || "en";
-    const outputFormat = ((args?.output_format as string) || "text") as OutputFormat;
-    const threads = Math.min(SYSTEM_THREADS, Math.max(1, Math.round((args?.threads as number) || WHISPER_THREADS)));
-    const saveToFile = (args?.save_to_file as boolean) || false;
-
-    if (!filePath) return { content: [{ type: "text", text: "file_path is required." }], isError: true };
-    if (!existsSync(filePath)) return { content: [{ type: "text", text: `File not found: ${filePath}` }], isError: true };
-    const configError = validatePaths();
-    if (configError) return { content: [{ type: "text", text: configError }], isError: true };
-
-    try {
-      const result = await transcribeSingle(filePath, model, language, outputFormat, threads, saveToFile);
-      let response = result.text;
-      if (result.savedTo) response += `\n\n[Transcript saved to: ${result.savedTo}]`;
-      if (result.srtPath) response += `\n\n[SRT subtitle file saved to: ${result.srtPath}]`;
-      return { content: [{ type: "text", text: response }] };
-    } catch (err: any) {
-      return { content: [{ type: "text", text: `Transcription failed:\n\n${err?.stderr || err?.message || String(err)}` }], isError: true };
-    }
-  }
-
-  // -------------------------------------------------------------------------
-  // generate_subtitles
-  // -------------------------------------------------------------------------
-  if (name === "generate_subtitles") {
-    const filePath = args?.file_path as string;
-    const language = (args?.language as string) || "en";
-    const threads = Math.min(SYSTEM_THREADS, Math.max(1, Math.round((args?.threads as number) || WHISPER_THREADS)));
-
-    if (!filePath) return { content: [{ type: "text", text: "file_path is required." }], isError: true };
-    if (!existsSync(filePath)) return { content: [{ type: "text", text: `File not found: ${filePath}` }], isError: true };
-    const configError = validatePaths();
-    if (configError) return { content: [{ type: "text", text: configError }], isError: true };
-
-    try {
-      const result = await transcribeSingle(filePath, WHISPER_MODEL, language, "srt", threads, false);
-      return {
-        content: [{
-          type: "text",
-          text:
-            `✅ Subtitle file generated!\n\n` +
-            `Saved to: ${result.srtPath}\n\n` +
-            `To use in VLC: Subtitle → Add Subtitle File → select the .srt file.\n` +
-            `Works in any video player that supports external subtitles.`,
-        }],
-      };
-    } catch (err: any) {
-      return { content: [{ type: "text", text: `Subtitle generation failed:\n\n${err?.stderr || err?.message || String(err)}` }], isError: true };
-    }
-  }
-
-  // -------------------------------------------------------------------------
-  // transcribe_batch (interactive only)
-  // -------------------------------------------------------------------------
-  if (name === "transcribe_batch") {
-    const folderPath = args?.folder_path as string;
-    const language = (args?.language as string) || "en";
-    const threads = Math.min(SYSTEM_THREADS, Math.max(1, Math.round((args?.threads as number) || WHISPER_THREADS)));
-    const recursive = (args?.recursive as boolean) || false;
-    const fileIndex = args?.file_index as number | undefined;
-
-    if (!folderPath) return { content: [{ type: "text", text: "folder_path is required." }], isError: true };
-    if (!existsSync(folderPath)) return { content: [{ type: "text", text: `Folder not found: ${folderPath}` }], isError: true };
-    const configError = validatePaths();
-    if (configError) return { content: [{ type: "text", text: configError }], isError: true };
-
-    const files = getFiles(folderPath, recursive);
-
-    if (files.length === 0) {
-      return {
-        content: [{
-          type: "text",
-          text: `No supported files found in: ${folderPath}\nSupported formats: ${SUPPORTED_EXTENSIONS.join(", ")}`,
-        }],
-      };
-    }
-
-    // No file_index: return file list
-    if (fileIndex === undefined) {
-      return {
-        content: [{
-          type: "text",
-          text:
-            `Found ${files.length} file(s) in: ${folderPath}\n\n` +
-            files.map((f, i) => {
-              const txtPath = f.replace(/\.[^.]+$/, ".txt");
-              const done = existsSync(txtPath) ? " ✅ already done" : "";
-              return `  ${i + 1}. ${basename(f)}${done}`;
-            }).join("\n") +
-            `\n\nTo start, say "transcribe file 1" (or any number). I'll process one file at a time and wait for your go-ahead before continuing.\n` +
-            `\nFor large unattended batches, see the command line approach in TROUBLESHOOTING.md.`,
-        }],
-      };
-    }
-
-    // Process the requested file
-    const idx = fileIndex - 1;
-    if (idx < 0 || idx >= files.length) {
-      return { content: [{ type: "text", text: `Invalid file number. Choose between 1 and ${files.length}.` }], isError: true };
-    }
-
-    const filePath = files[idx];
-    const fileName = basename(filePath);
-    const txtPath = filePath.replace(/\.[^.]+$/, ".txt");
-
-    try {
-      const result = await transcribeSingle(filePath, WHISPER_MODEL, language, "text", threads, true);
-      const remaining = files.length - fileIndex;
-      const nextMsg = remaining > 0
-        ? `\n\n${remaining} file(s) remaining. Say "continue" or "transcribe file ${fileIndex + 1}" to proceed, or "stop" to finish.`
-        : `\n\n✅ That was the last file. Batch complete!`;
-
-      return {
-        content: [{
-          type: "text",
-          text:
-            `[${fileIndex}/${files.length}] ✅ ${fileName}\n\n` +
-            `Saved to: ${txtPath}\n\n` +
-            `Preview:\n${result.text.slice(0, 500)}${result.text.length > 500 ? "..." : ""}` +
-            nextMsg,
-        }],
-      };
-    } catch (err: any) {
-      return {
-        content: [{
-          type: "text",
-          text:
-            `[${fileIndex}/${files.length}] ❌ Failed: ${fileName}\n\n` +
-            `Error: ${err?.stderr || err?.message || String(err)}\n\n` +
-            `Say "transcribe file ${fileIndex + 1}" to skip and continue.`,
-        }],
-        isError: true,
-      };
-    }
-  }
-
-  return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
-});
-
-// ---------------------------------------------------------------------------
-// Start
-// ---------------------------------------------------------------------------
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error(`whisper-windows-mcp v1.4.0 running | threads: ${WHISPER_THREADS}/${SYSTEM_THREADS}`);
-}
-
-main().catch((err) => {
-  console.error("Fatal error:", err);
-  process.exit(1);
-});

package/src/index.ts.bak

@@ -1,446 +0,0 @@
-#!/usr/bin/env node
-/**
- * whisper-windows-mcp
- * A Windows-native MCP server for local audio transcription using whisper.cpp
- * https://github.com/eviscerations/whisper-windows-mcp
- */
-
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-} from "@modelcontextprotocol/sdk/types.js";
-import { execFile } from "child_process";
-import {
-  existsSync, unlinkSync, readdirSync,
-  writeFileSync, readFileSync
-} from "fs";
-import { cpus, tmpdir } from "os";
-import { join, extname, basename } from "path";
-import { promisify } from "util";
-
-const execFileAsync = promisify(execFile);
-
-// ---------------------------------------------------------------------------
-// Configuration
-// ---------------------------------------------------------------------------
-const WHISPER_CLI_PATH =
-  process.env.WHISPER_CLI_PATH ?? "C:\\whisper\\Release\\whisper-cli.exe";
-const WHISPER_MODEL =
-  process.env.WHISPER_MODEL ?? "C:\\whisper\\models\\ggml-base.en.bin";
-const FFMPEG_PATH =
-  process.env.FFMPEG_PATH ?? "ffmpeg";
-
-const SYSTEM_THREADS = cpus().length;
-const DEFAULT_THREADS = Math.max(2, Math.floor(SYSTEM_THREADS / 2));
-const WHISPER_THREADS = parseInt(process.env.WHISPER_THREADS ?? String(DEFAULT_THREADS), 10);
-
-const SUPPORTED_EXTENSIONS = [
-  ".mp3", ".wav",
-  ".mp4", ".mkv", ".avi", ".mov", ".webm", ".flv", ".wmv", ".m4v",
-  ".m4a", ".ogg", ".flac",
-];
-const NATIVE_EXTENSIONS = [".mp3", ".wav"];
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-function validatePaths(): string | null {
-  if (!existsSync(WHISPER_CLI_PATH))
-    return `whisper-cli.exe not found at: ${WHISPER_CLI_PATH}\nCheck WHISPER_CLI_PATH in claude_desktop_config.json`;
-  if (!existsSync(WHISPER_MODEL))
-    return `Whisper model not found at: ${WHISPER_MODEL}\nCheck WHISPER_MODEL in claude_desktop_config.json`;
-  return null;
-}
-
-/**
- * Check whether a whisper-cli.exe process is already running.
- * Uses tasklist /FI which is available on all Windows versions.
- * Returns true if found, false if not (or if tasklist itself fails).
- */
-async function isWhisperRunning(): Promise<boolean> {
-  try {
-    const { stdout } = await execFileAsync(
-      "tasklist",
-      ["/FI", "IMAGENAME eq whisper-cli.exe", "/NH"],
-      { windowsHide: true }
-    );
-    return stdout.toLowerCase().includes("whisper-cli.exe");
-  } catch {
-    // If tasklist fails for any reason, assume safe to proceed
-    return false;
-  }
-}
-
-function needsConversion(filePath: string): boolean {
-  return !NATIVE_EXTENSIONS.includes(extname(filePath).toLowerCase());
-}
-
-function isSupportedFile(filePath: string): boolean {
-  return SUPPORTED_EXTENSIONS.includes(extname(filePath).toLowerCase());
-}
-
-async function convertToWav(inputPath: string): Promise<string> {
-  const tmpFile = join(tmpdir(), `whisper_tmp_${Date.now()}.wav`);
-  await execFileAsync(FFMPEG_PATH, [
-    "-y", "-i", inputPath,
-    "-ar", "16000", "-ac", "1", "-c:a", "pcm_s16le", tmpFile,
-  ], { windowsHide: true });
-  return tmpFile;
-}
-
-type OutputFormat = "text" | "timestamps" | "json" | "srt";
-
-function buildArgs(
-  filePath: string, model: string, language: string,
-  outputFormat: OutputFormat, threads: number
-): string[] {
-  const args = ["-m", model, "-f", filePath, "-l", language, "-t", String(threads)];
-  if (outputFormat === "srt") {
-    args.push("-osrt", "-of", filePath.replace(/\.[^.]+$/, ""));
-  } else if (outputFormat === "json") {
-    args.push("-oj");
-  } else if (outputFormat === "text") {
-    args.push("--no-timestamps");
-  }
-  return args;
-}
-
-async function transcribeSingle(
-  filePath: string, model: string, language: string,
-  outputFormat: OutputFormat, threads: number, saveToFile = false
-): Promise<{ text: string; srtPath?: string; savedTo?: string }> {
-
-  // ---- Priority 2: Process lock ----
-  // Never spawn a second whisper-cli.exe while one is already running.
-  if (await isWhisperRunning()) {
-    throw new Error(
-      "Transcription already in progress.\n\n" +
-      "whisper-cli.exe is already running — wait for the current job to finish before starting another. " +
-      "If you believe this is wrong (e.g. a previous job crashed and left a stale process), " +
-      "open Task Manager, find whisper-cli.exe under Details, and end the task."
-    );
-  }
-
-  let transcribeFrom = filePath;
-  let tmpFile: string | null = null;
-
-  if (needsConversion(filePath)) {
-    tmpFile = await convertToWav(filePath);
-    transcribeFrom = tmpFile;
-  }
-
-  try {
-    const cliArgs = buildArgs(transcribeFrom, model, language, outputFormat, threads);
-    const { stdout, stderr } = await execFileAsync(WHISPER_CLI_PATH, cliArgs, {
-      maxBuffer: 100 * 1024 * 1024,
-      windowsHide: true,
-    });
-
-    const output = (stdout || stderr || "").trim();
-
-    if (outputFormat === "srt") {
-      const tmpSrt = transcribeFrom.replace(/\.[^.]+$/, ".srt");
-      const destSrt = filePath.replace(/\.[^.]+$/, ".srt");
-      if (tmpFile && existsSync(tmpSrt)) {
-        writeFileSync(destSrt, readFileSync(tmpSrt, "utf8"));
-        try { unlinkSync(tmpSrt); } catch { }
-      }
-      return { text: output, srtPath: destSrt };
-    }
-
-    if (saveToFile) {
-      const txtPath = filePath.replace(/\.[^.]+$/, ".txt");
-      writeFileSync(txtPath, output, "utf8");
-      return { text: output, savedTo: txtPath };
-    }
-
-    return { text: output };
-  } finally {
-    if (tmpFile && existsSync(tmpFile)) try { unlinkSync(tmpFile); } catch { }
-  }
-}
-
-function getFiles(dir: string, recursive: boolean): string[] {
-  const entries = readdirSync(dir, { withFileTypes: true });
-  const files: string[] = [];
-  for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
-    if (entry.isDirectory() && recursive) files.push(...getFiles(fullPath, true));
-    else if (entry.isFile() && isSupportedFile(entry.name)) files.push(fullPath);
-  }
-  return files;
-}
-
-// ---------------------------------------------------------------------------
-// MCP Server
-// ---------------------------------------------------------------------------
-const server = new Server(
-  { name: "whisper-windows-mcp", version: "1.3.1" },
-  { capabilities: { tools: {} } }
-);
-
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: [
-    {
-      name: "transcribe_audio",
-      description:
-        "Transcribe a single audio or video file using whisper.cpp on Windows. " +
-        "Natively supports mp3 and wav. Automatically converts mp4, mkv, avi, mov, " +
-        "webm, m4a, flac, ogg etc. via FFmpeg — no manual conversion needed. " +
-        "Can output plain text, timestamps, JSON, or SRT subtitle files. " +
-        "WARNING: files over 30 minutes cannot be cancelled cleanly from Claude — " +
-        "use Task Manager to kill the process if needed.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          file_path: { type: "string", description: "Absolute Windows path, e.g. C:\\Users\\You\\Downloads\\recording.mp4" },
-          model: { type: "string", description: "Override model path. Leave blank to use WHISPER_MODEL." },
-          language: { type: "string", description: "Language code, e.g. en, es, fr. Defaults to en.", default: "en" },
-          output_format: {
-            type: "string", enum: ["text", "timestamps", "json", "srt"],
-            description: "text = plain (default), timestamps = with time codes, json = structured, srt = subtitle file saved next to source.",
-            default: "text",
-          },
-          threads: { type: "number", description: `CPU threads. Defaults to ${WHISPER_THREADS} of ${SYSTEM_THREADS}.` },
-          save_to_file: { type: "boolean", description: "Save transcript as .txt next to the source file.", default: false },
-        },
-        required: ["file_path"],
-      },
-    },
-    {
-      name: "transcribe_batch",
-      description:
-        "Transcribe multiple audio/video files in a folder interactively, one file at a time. " +
-        "Shows a preview of each transcript and waits for confirmation before continuing. " +
-        "Saves each transcript as a .txt file next to its source. " +
-        "Files already transcribed (with matching .txt) are shown as done and skipped. " +
-        "Supported formats: mp3, wav, mp4, mkv, avi, mov, webm, m4a, flac, ogg. " +
-        "NOTE: For large unattended batch jobs, use whisper-cli.exe directly from the command line " +
-        "— see TROUBLESHOOTING.md for the command syntax.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          folder_path: { type: "string", description: "Absolute Windows path to the folder." },
-          file_index: {
-            type: "number",
-            description: "Which file to process (1-based). Omit to list files first.",
-          },
-          language: { type: "string", description: "Language code. Defaults to en.", default: "en" },
-          threads: { type: "number", description: `CPU threads. Defaults to ${WHISPER_THREADS} of ${SYSTEM_THREADS}.` },
-          recursive: { type: "boolean", description: "Include subfolders. Defaults to false.", default: false },
-        },
-        required: ["folder_path"],
-      },
-    },
-    {
-      name: "generate_subtitles",
-      description:
-        "Generate an SRT subtitle file for an audio or video file. " +
-        "Saved next to the source file. Load in VLC via Subtitle → Add Subtitle File. " +
-        "Supports all the same formats as transcribe_audio.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          file_path: { type: "string", description: "Absolute Windows path to the file." },
-          language: { type: "string", description: "Language code. Defaults to en.", default: "en" },
-          threads: { type: "number", description: `CPU threads. Defaults to ${WHISPER_THREADS} of ${SYSTEM_THREADS}.` },
-        },
-        required: ["file_path"],
-      },
-    },
-    {
-      name: "check_config",
-      description: "Verify whisper-cli.exe, model, and FFmpeg are all available. Run this first if anything fails.",
-      inputSchema: { type: "object", properties: {} },
-    },
-  ],
-}));
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-
-  // -------------------------------------------------------------------------
-  // check_config
-  // -------------------------------------------------------------------------
-  if (name === "check_config") {
-    const error = validatePaths();
-    if (error) return { content: [{ type: "text", text: `❌ Configuration error:\n\n${error}` }], isError: true };
-
-    let ffmpegStatus = "✅ Found";
-    try { await execFileAsync(FFMPEG_PATH, ["-version"], { windowsHide: true }); }
-    catch { ffmpegStatus = "⚠️  Not found — video/non-MP3 formats require FFmpeg in PATH"; }
-
-    return {
-      content: [{
-        type: "text",
-        text:
-          `✅ Configuration looks good!\n\n` +
-          `whisper-cli: ${WHISPER_CLI_PATH}\n` +
-          `Model:       ${WHISPER_MODEL}\n` +
-          `Threads:     ${WHISPER_THREADS} of ${SYSTEM_THREADS} logical cores\n` +
-          `FFmpeg:      ${ffmpegStatus}\n\n` +
-          `Optional env vars: WHISPER_THREADS, FFMPEG_PATH`,
-      }],
-    };
-  }
-
-  // -------------------------------------------------------------------------
-  // transcribe_audio
-  // -------------------------------------------------------------------------
-  if (name === "transcribe_audio") {
-    const filePath = args?.file_path as string;
-    const model = (args?.model as string) || WHISPER_MODEL;
-    const language = (args?.language as string) || "en";
-    const outputFormat = ((args?.output_format as string) || "text") as OutputFormat;
-    const threads = Math.min(SYSTEM_THREADS, Math.max(1, Math.round((args?.threads as number) || WHISPER_THREADS)));
-    const saveToFile = (args?.save_to_file as boolean) || false;
-
-    if (!filePath) return { content: [{ type: "text", text: "file_path is required." }], isError: true };
-    if (!existsSync(filePath)) return { content: [{ type: "text", text: `File not found: ${filePath}` }], isError: true };
-    const configError = validatePaths();
-    if (configError) return { content: [{ type: "text", text: configError }], isError: true };
-
-    try {
-      const result = await transcribeSingle(filePath, model, language, outputFormat, threads, saveToFile);
-      let response = result.text;
-      if (result.savedTo) response += `\n\n[Transcript saved to: ${result.savedTo}]`;
-      if (result.srtPath) response += `\n\n[SRT subtitle file saved to: ${result.srtPath}]`;
-      return { content: [{ type: "text", text: response }] };
-    } catch (err: any) {
-      return { content: [{ type: "text", text: `Transcription failed:\n\n${err?.stderr || err?.message || String(err)}` }], isError: true };
-    }
-  }
-
-  // -------------------------------------------------------------------------
-  // generate_subtitles
-  // -------------------------------------------------------------------------
-  if (name === "generate_subtitles") {
-    const filePath = args?.file_path as string;
-    const language = (args?.language as string) || "en";
-    const threads = Math.min(SYSTEM_THREADS, Math.max(1, Math.round((args?.threads as number) || WHISPER_THREADS)));
-
-    if (!filePath) return { content: [{ type: "text", text: "file_path is required." }], isError: true };
-    if (!existsSync(filePath)) return { content: [{ type: "text", text: `File not found: ${filePath}` }], isError: true };
-    const configError = validatePaths();
-    if (configError) return { content: [{ type: "text", text: configError }], isError: true };
-
-    try {
-      const result = await transcribeSingle(filePath, WHISPER_MODEL, language, "srt", threads, false);
-      return {
-        content: [{
-          type: "text",
-          text:
-            `✅ Subtitle file generated!\n\n` +
-            `Saved to: ${result.srtPath}\n\n` +
-            `To use in VLC: Subtitle → Add Subtitle File → select the .srt file.\n` +
-            `Works in any video player that supports external subtitles.`,
-        }],
-      };
-    } catch (err: any) {
-      return { content: [{ type: "text", text: `Subtitle generation failed:\n\n${err?.stderr || err?.message || String(err)}` }], isError: true };
-    }
-  }
-
-  // -------------------------------------------------------------------------
-  // transcribe_batch (interactive only)
-  // -------------------------------------------------------------------------
-  if (name === "transcribe_batch") {
-    const folderPath = args?.folder_path as string;
-    const language = (args?.language as string) || "en";
-    const threads = Math.min(SYSTEM_THREADS, Math.max(1, Math.round((args?.threads as number) || WHISPER_THREADS)));
-    const recursive = (args?.recursive as boolean) || false;
-    const fileIndex = args?.file_index as number | undefined;
-
-    if (!folderPath) return { content: [{ type: "text", text: "folder_path is required." }], isError: true };
-    if (!existsSync(folderPath)) return { content: [{ type: "text", text: `Folder not found: ${folderPath}` }], isError: true };
-    const configError = validatePaths();
-    if (configError) return { content: [{ type: "text", text: configError }], isError: true };
-
-    const files = getFiles(folderPath, recursive);
-
-    if (files.length === 0) {
-      return {
-        content: [{
-          type: "text",
-          text: `No supported files found in: ${folderPath}\nSupported formats: ${SUPPORTED_EXTENSIONS.join(", ")}`,
-        }],
-      };
-    }
-
-    // No file_index: return file list
-    if (fileIndex === undefined) {
-      return {
-        content: [{
-          type: "text",
-          text:
-            `Found ${files.length} file(s) in: ${folderPath}\n\n` +
-            files.map((f, i) => {
-              const txtPath = f.replace(/\.[^.]+$/, ".txt");
-              const done = existsSync(txtPath) ? " ✅ already done" : "";
-              return `  ${i + 1}. ${basename(f)}${done}`;
-            }).join("\n") +
-            `\n\nTo start, say "transcribe file 1" (or any number). I'll process one file at a time and wait for your go-ahead before continuing.\n` +
-            `\nFor large unattended batches, see the command line approach in TROUBLESHOOTING.md.`,
-        }],
-      };
-    }
-
-    // Process the requested file
-    const idx = fileIndex - 1;
-    if (idx < 0 || idx >= files.length) {
-      return { content: [{ type: "text", text: `Invalid file number. Choose between 1 and ${files.length}.` }], isError: true };
-    }
-
-    const filePath = files[idx];
-    const fileName = basename(filePath);
-    const txtPath = filePath.replace(/\.[^.]+$/, ".txt");
-
-    try {
-      const result = await transcribeSingle(filePath, WHISPER_MODEL, language, "text", threads, true);
-      const remaining = files.length - fileIndex;
-      const nextMsg = remaining > 0
-        ? `\n\n${remaining} file(s) remaining. Say "continue" or "transcribe file ${fileIndex + 1}" to proceed, or "stop" to finish.`
-        : `\n\n✅ That was the last file. Batch complete!`;
-
-      return {
-        content: [{
-          type: "text",
-          text:
-            `[${fileIndex}/${files.length}] ✅ ${fileName}\n\n` +
-            `Saved to: ${txtPath}\n\n` +
-            `Preview:\n${result.text.slice(0, 500)}${result.text.length > 500 ? "..." : ""}` +
-            nextMsg,
-        }],
-      };
-    } catch (err: any) {
-      return {
-        content: [{
-          type: "text",
-          text:
-            `[${fileIndex}/${files.length}] ❌ Failed: ${fileName}\n\n` +
-            `Error: ${err?.stderr || err?.message || String(err)}\n\n` +
-            `Say "transcribe file ${fileIndex + 1}" to skip and continue.`,
-        }],
-        isError: true,
-      };
-    }
-  }
-
-  return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
-});
-
-// ---------------------------------------------------------------------------
-// Start
-// ---------------------------------------------------------------------------
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error(`whisper-windows-mcp v1.3.1 running | threads: ${WHISPER_THREADS}/${SYSTEM_THREADS}`);
-}
-
-main().catch((err) => {
-  console.error("Fatal error:", err);
-  process.exit(1);
-});

package/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ES2020",
-    "moduleResolution": "node",
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "declaration": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}