voice-mcp-server 0.1.0 → 0.1.2

package/README.md

@@ -121,15 +121,14 @@ pip install -r requirements.txt
 
 ### 3. Install the NPM Bridge
 
-Install the package globally, or simply rely on `npx` when configuring your client:
+You can run the server directly via `npx` without installing it globally, or install it globally via `npm`:
 
 ```bash
-# Build the TypeScript entry point
-npm install
-npm run build
-
 # Install globally
-npm install -g .
+npm install -g voice-mcp-server
+
+# Or run directly via npx
+npx -y voice-mcp-server
 ```
 
 -----
@@ -142,7 +141,7 @@ You can seamlessly plug Voice MCP Server into any standard MCP-compatible client
 
 Add the server to your global configuration:
 ```bash
-gemini mcp add voice-mcp-server node /absolute/path/to/voice_mcp_server/build/index.js
+gemini mcp add voice-mcp-server npx -y voice-mcp-server
 ```
 
 ### For Cursor
@@ -151,7 +150,7 @@ gemini mcp add voice-mcp-server node /absolute/path/to/voice_mcp_server/build/in
 2.  Click **+ Add New MCP Server**
 3.  **Name:** `Voice`
 4.  **Type:** `command`
-5.  **Command:** `node /absolute/path/to/voice_mcp_server/build/index.js`
+5.  **Command:** `npx -y voice-mcp-server`
 
 ### For Claude Desktop
 
@@ -161,8 +160,8 @@ Add the following to your `claude_desktop_config.json` (usually located at `~/Li
 {
   "mcpServers": {
     "voice-mcp": {
-      "command": "node",
-      "args": ["/absolute/path/to/voice_mcp_server/build/index.js"]
+      "command": "npx",
+      "args": ["-y", "voice-mcp-server"]
     }
   }
 }

package/build/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { existsSync } from "node:fs";
@@ -10,31 +10,59 @@ const __dirname = dirname(__filename);
 const projectRoot = join(__dirname, "..");
 // Path to the Python script
 const pythonScriptPath = join(projectRoot, "src", "mcp_server.py");
+const venvPath = join(projectRoot, "venv");
+const venvPythonPath = join(venvPath, "bin", "python3");
+const requirementsPath = join(projectRoot, "requirements.txt");
 /**
- * Locate the best Python executable to use.
- * Priority:
- * 1. Local venv inside the project
- * 2. System python3
+ * Strips npm/npx specific environment variables that can break Python virtual environments.
  */
-function getPythonExecutable() {
-    const venvPath = join(projectRoot, "venv", "bin", "python3");
-    if (existsSync(venvPath)) {
-        return venvPath;
+function cleanEnv() {
+    const env = { ...process.env, PYTHONUNBUFFERED: "1" };
+    for (const key in env) {
+        if (key.toLowerCase().startsWith("npm_")) {
+            delete env[key];
+        }
+    }
+    return env;
+}
+/**
+ * Ensures the Python virtual environment exists and dependencies are installed.
+ */
+function ensurePythonEnvironment() {
+    if (!existsSync(venvPath)) {
+        console.error("Voice MCP: Initializing Python virtual environment. This may take a minute...");
+        // Create the virtual environment
+        const venvResult = spawnSync("python3", ["-m", "venv", "venv"], {
+            cwd: projectRoot,
+            stdio: "inherit",
+            env: cleanEnv()
+        });
+        if (venvResult.status !== 0) {
+            console.error("Voice MCP: Failed to create Python virtual environment.");
+            process.exit(1);
+        }
+        console.error("Voice MCP: Installing ML dependencies (silero-vad, mlx-whisper, kokoro, etc.)...");
+        // Install requirements
+        const pipResult = spawnSync(venvPythonPath, ["-m", "pip", "install", "-r", requirementsPath], {
+            cwd: projectRoot,
+            stdio: "inherit",
+            env: cleanEnv()
+        });
+        if (pipResult.status !== 0) {
+            console.error("Voice MCP: Failed to install Python dependencies.");
+            process.exit(1);
+        }
+        console.error("Voice MCP: Environment setup complete!");
     }
-    return "python3";
 }
-const pythonExecutable = getPythonExecutable();
 /**
  * Start the Python MCP Server and bridge standard I/O.
  */
 function startBridge() {
-    const pythonProcess = spawn(pythonExecutable, [pythonScriptPath], {
+    ensurePythonEnvironment();
+    const pythonProcess = spawn(venvPythonPath, [pythonScriptPath], {
         stdio: ["pipe", "pipe", "inherit"],
-        env: {
-            ...process.env,
-            // Ensure Python output isn't buffered
-            PYTHONUNBUFFERED: "1",
-        },
+        env: cleanEnv()
     });
     // Pipe our stdin into Python's stdin
     process.stdin.pipe(pythonProcess.stdin);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "voice-mcp-server",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "An MCP server to allow LLMs to speak and listen via bidirectional voice loops",
   "main": "build/index.js",
   "type": "module",

package/src/index.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { existsSync } from "node:fs";
@@ -14,34 +14,69 @@ const projectRoot = join(__dirname, "..");
 
 // Path to the Python script
 const pythonScriptPath = join(projectRoot, "src", "mcp_server.py");
+const venvPath = join(projectRoot, "venv");
+const venvPythonPath = join(venvPath, "bin", "python3");
+const requirementsPath = join(projectRoot, "requirements.txt");
 
 /**
- * Locate the best Python executable to use.
- * Priority:
- * 1. Local venv inside the project
- * 2. System python3
+ * Strips npm/npx specific environment variables that can break Python virtual environments.
  */
-function getPythonExecutable(): string {
-  const venvPath = join(projectRoot, "venv", "bin", "python3");
-  if (existsSync(venvPath)) {
-    return venvPath;
+function cleanEnv(): NodeJS.ProcessEnv {
+  const env: Record<string, string | undefined> = { ...process.env, PYTHONUNBUFFERED: "1" };
+  for (const key in env) {
+    if (key.toLowerCase().startsWith("npm_")) {
+      delete env[key];
+    }
   }
-  return "python3";
+  return env as NodeJS.ProcessEnv;
 }
 
-const pythonExecutable = getPythonExecutable();
+/**
+ * Ensures the Python virtual environment exists and dependencies are installed.
+ */
+function ensurePythonEnvironment() {
+  if (!existsSync(venvPath)) {
+    console.error("Voice MCP: Initializing Python virtual environment. This may take a minute...");
+    
+    // Create the virtual environment
+    const venvResult = spawnSync("python3", ["-m", "venv", "venv"], {
+      cwd: projectRoot,
+      stdio: "inherit",
+      env: cleanEnv()
+    });
+
+    if (venvResult.status !== 0) {
+      console.error("Voice MCP: Failed to create Python virtual environment.");
+      process.exit(1);
+    }
+
+    console.error("Voice MCP: Installing ML dependencies (silero-vad, mlx-whisper, kokoro, etc.)...");
+    
+    // Install requirements
+    const pipResult = spawnSync(venvPythonPath, ["-m", "pip", "install", "-r", requirementsPath], {
+      cwd: projectRoot,
+      stdio: "inherit",
+      env: cleanEnv()
+    });
+
+    if (pipResult.status !== 0) {
+      console.error("Voice MCP: Failed to install Python dependencies.");
+      process.exit(1);
+    }
+    
+    console.error("Voice MCP: Environment setup complete!");
+  }
+}
 
 /**
  * Start the Python MCP Server and bridge standard I/O.
  */
 function startBridge() {
-  const pythonProcess = spawn(pythonExecutable, [pythonScriptPath], {
+  ensurePythonEnvironment();
+
+  const pythonProcess = spawn(venvPythonPath, [pythonScriptPath], {
     stdio: ["pipe", "pipe", "inherit"],
-    env: {
-      ...process.env,
-      // Ensure Python output isn't buffered
-      PYTHONUNBUFFERED: "1",
-    },
+    env: cleanEnv()
   });
 
   // Pipe our stdin into Python's stdin
@@ -61,3 +96,4 @@ function startBridge() {
 }
 
 startBridge();
+