whisper-windows-mcp 1.4.2 → 1.5.0

package/dist/index.js

@@ -10,7 +10,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextpro
 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 { join, extname, basename, dirname } from "path";
 import { promisify } from "util";
 const execFileAsync = promisify(execFile);
 // ---------------------------------------------------------------------------
@@ -53,6 +53,48 @@ async function isWhisperRunning() {
         return false;
     }
 }
+async function detectGpus() {
+    try {
+        const { stdout } = await execFileAsync("wmic", ["path", "win32_VideoController", "get", "name,AdapterRAM", "/format:csv"], { windowsHide: true });
+        const gpus = [];
+        for (const line of stdout.split(/\r?\n/)) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("Node") || trimmed.startsWith(",AdapterRAM"))
+                continue;
+            const parts = trimmed.split(",");
+            if (parts.length < 3)
+                continue;
+            const vramBytes = parseInt(parts[1] ?? "0", 10) || 0;
+            const name = (parts[2] ?? "").trim();
+            if (name && name !== "Name")
+                gpus.push({ name, vramBytes });
+        }
+        return gpus;
+    }
+    catch {
+        return [];
+    }
+}
+function formatVram(bytes) {
+    if (!bytes || bytes < 1024 * 1024)
+        return "Unknown";
+    const gb = bytes / (1024 * 1024 * 1024);
+    return gb >= 1 ? `${gb.toFixed(1)} GB` : `${Math.round(bytes / (1024 * 1024))} MB`;
+}
+function recommendedModel(vramBytes) {
+    const gb = vramBytes / (1024 * 1024 * 1024);
+    if (gb >= 6)
+        return "large-v3 (ggml-large-v3.bin) — fits comfortably in your VRAM";
+    if (gb >= 4)
+        return "medium.en (ggml-medium.en.bin) — good fit for your VRAM";
+    if (gb >= 2)
+        return "small.en (ggml-small.en.bin) — safe choice for your VRAM";
+    return "base.en (ggml-base.en.bin) — recommended for limited VRAM";
+}
+function hasVulkanDll() {
+    const whisperDir = dirname(WHISPER_CLI_PATH);
+    return existsSync(join(whisperDir, "ggml-vulkan.dll"));
+}
 function needsConversion(filePath) {
     return !NATIVE_EXTENSIONS.includes(extname(filePath).toLowerCase());
 }
@@ -144,7 +186,7 @@ function getFiles(dir, recursive) {
 // ---------------------------------------------------------------------------
 // MCP Server
 // ---------------------------------------------------------------------------
-const server = new Server({ name: "whisper-windows-mcp", version: "1.4.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "whisper-windows-mcp", version: "1.5.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -216,6 +258,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
             description: "Verify whisper-cli.exe, model, and FFmpeg are all available. Run this first if anything fails.",
             inputSchema: { type: "object", properties: {} },
         },
+        {
+            name: "check_system",
+            description: "Detect GPU hardware and verify Vulkan acceleration is available. " +
+                "Reports GPU name, VRAM, whether the Vulkan binary is installed, " +
+                "and recommends the best Whisper model for your hardware. " +
+                "Run this if you want to confirm GPU acceleration is working or diagnose why it isn't.",
+            inputSchema: { type: "object", properties: {} },
+        },
     ],
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -247,6 +297,41 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
     }
     // -------------------------------------------------------------------------
+    // check_system
+    // -------------------------------------------------------------------------
+    if (name === "check_system") {
+        const vulkan = hasVulkanDll();
+        const gpus = await detectGpus();
+        let gpuLines = "";
+        if (gpus.length === 0) {
+            gpuLines = "⚠️  No GPU detected via wmic — this may indicate a driver issue.\n";
+        }
+        else {
+            for (const gpu of gpus) {
+                const vramStr = formatVram(gpu.vramBytes);
+                gpuLines += `🖥️  GPU:   ${gpu.name}\n`;
+                gpuLines += `💾  VRAM:  ${vramStr} (reported by Windows — may be half of actual on AMD cards)\n`;
+                if (gpu.vramBytes > 0) {
+                    gpuLines += `📦  Recommended model: ${recommendedModel(gpu.vramBytes)}\n`;
+                }
+                gpuLines += "\n";
+            }
+        }
+        const vulkanLine = vulkan
+            ? `✅ Vulkan binary:  ggml-vulkan.dll found — GPU acceleration is active`
+            : `❌ Vulkan binary:  ggml-vulkan.dll NOT found — whisper is running CPU-only\n\n` +
+                `   To enable GPU acceleration:\n` +
+                `   Download whisper-vulkan-win-x64.zip from:\n` +
+                `   https://github.com/eviscerations/whisper-windows-mcp/releases\n` +
+                `   Extract to: ${dirname(WHISPER_CLI_PATH)}`;
+        return {
+            content: [{
+                    type: "text",
+                    text: `System check\n${"─".repeat(40)}\n\n${gpuLines}${vulkanLine}`,
+                }],
+        };
+    }
+    // -------------------------------------------------------------------------
     // transcribe_audio
     // -------------------------------------------------------------------------
     if (name === "transcribe_audio") {
@@ -391,7 +476,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 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}`);
+    console.error(`whisper-windows-mcp v1.5.0 running | threads: ${WHISPER_THREADS}/${SYSTEM_THREADS}`);
 }
 main().catch((err) => {
     console.error("Fatal error:", err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whisper-windows-mcp",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "description": "Windows-native MCP server for local audio transcription using whisper.cpp with Vulkan GPU acceleration",
   "main": "dist/index.js",
   "bin": {