voice-mcp-server 0.1.18 → 0.1.20

package/README.md

@@ -65,8 +65,8 @@ The system is built on a highly modular adapter pattern configured via `hydra` Y
 | | `kokoro_speaker` | High-quality, emotive local ML Text-to-Speech. |
 | | `elevenlabs_speaker` | Premium cloud-based ultra-realistic voices. |
 | **🎙️ Microphones** | `live_mic` | Direct hardware integration via PyAudio. |
-| **🤫 VAD (Activity)** | `silero_vad` | Conversational mode powered by Silero, heavily optimized for 1-second barge-ins. |
-| | `ptt_vad` | Manual Push-to-Talk / Walkie-Talkie mode for noisy environments. **(Default: Hold 'Shift' to talk)** |
+| **🤫 VAD (Activity)** | `silero_vad` | Conversational mode powered by Silero, heavily optimized for 1-second barge-ins. **(Default)** |
+| | `ptt_vad` | Manual Push-to-Talk mode. *(Note: Requires macOS Input Monitoring permissions for your terminal).* |
 | **📝 STT (Transcription)**| `mlx_whisper_large_v3`| Blazing fast local transcription leveraging Apple's MLX framework. |
 
 -----
@@ -80,7 +80,7 @@ Once connected, the server equips your AI agent with two powerful MCP tools:
 The core communication loop. The AI calls this tool and passes a string of text it wants to say.
 
 1.  The server renders and plays the TTS.
-2.  The server instantly activates the microphone and listens for the user's reply via VAD. *(Note: By default, the server is configured to use Push-To-Talk. You must press and hold the **Shift** key on your keyboard to speak or interrupt. You can ask the AI to change this!)*
+2.  The server instantly activates the microphone and listens for the user's reply via VAD. *(Note: By default, the server is configured to use Conversational Mode via Silero VAD).*
 3.  The server transcribes the audio and returns the text to the AI.
 
 **Interrupt Handling (Barge-in):** If the user interrupts the AI mid-sentence, playback instantly stops. The server captures the interruption, transcribes it, and returns the response alongside a `was_interrupted: true` flag. This allows the AI to organically realize it was cut off and address the interruption naturally.
@@ -113,15 +113,15 @@ npm install -g voice-mcp-server
 ```
 
 ### 3. Connect to your MCP Client
-You can now add the server to your favorite client. Using `npx -y` ensures it works seamlessly whether you installed it globally or not:
+You can now add the server to your favorite client. Using the globally installed command is the fastest method:
 
 **For Gemini CLI:**
 ```bash
-gemini mcp add voice-mcp-server --scope user npx -y voice-mcp-server
+gemini mcp add voice-mcp-server --scope user voice-mcp-server
 ```
 
 **For Cursor / Claude Desktop:**
-Simply use `npx` and `-y` as the command in your configuration.
+Simply use `voice-mcp-server` as the command in your configuration.
 
 > [!NOTE]  
 > **First Run Performance:** The very first time you invoke the voice tool, it will take a few minutes to initialize the Python environment and download the heavy ML weights (~4GB). **The tools will not be available until this background setup completes.** You can monitor progress in your terminal logs. *Depending on your AI client, you may need to restart the application/CLI for the tools to appear after setup.*

package/config/config.yaml

@@ -11,7 +11,7 @@ defaults:
   # Available VADs: 
   #   - ptt_vad: Walkie-Talkie mode (Hold 'Shift' to talk. Instant response. Ignores TV/noise).
   #   - silero_vad: Conversational AI mode (Listens automatically. Tuned for 1-second barge-ins).
-  - vad: ptt_vad
+  - vad: silero_vad
   
   # Available STTs: mlx_whisper_large_v3 (Apple Silicon GPU), whisper_stt (Google Cloud API)
   - stt: mlx_whisper_large_v3

package/package.json

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