What is Ms Lucidia Voice Gateway Mcp

MS-Lucidia-Voice-Gateway-MCP is a Model Context Protocol (MCP) server that provides dynamic audio processing capabilities, including text-to-speech (TTS) and speech-to-text (STT), utilizing Microsoft’s built-in speech services through the Windows Speech API (SAPI).

Use cases

Use cases include converting written content to spoken words for accessibility, enabling voice commands for applications, transcribing spoken language into text for documentation, and providing interactive learning experiences through voice interaction.

How to use

To use MS-Lucidia-Voice-Gateway-MCP, clone the repository, install the dependencies, and build the project. Start the test server and access the web interface at http://localhost:3000 to test TTS and STT functionalities.

Key features

Key features include: 1) Text-to-Speech (TTS) using Windows SAPI voices, 2) Speech-to-Text (STT) using Windows Speech Recognition, 3) A simple web interface for testing, 4) No external API dependencies, and 5) Utilization of native Windows capabilities.

Where to use

MS-Lucidia-Voice-Gateway-MCP can be used in various fields such as accessibility tools for the visually impaired, voice assistants, interactive voice response systems, and educational applications requiring speech interaction.

MS-Lucidia-Voice-Gateway-MCP

A Model Context Protocol (MCP) server that provides text-to-speech and speech-to-text capabilities using Windows’ built-in speech services. This server leverages the native Windows Speech API (SAPI) through PowerShell commands, eliminating the need for external APIs or services.

Features

• Text-to-Speech (TTS) using Windows SAPI voices
• Speech-to-Text (STT) using Windows Speech Recognition
• Simple web interface for testing
• No external API dependencies
• Uses native Windows capabilities

Prerequisites

• Windows 10/11 with Speech Recognition enabled
• Node.js 16+
• PowerShell

Installation

1. Clone the repository:

git clone https://github.com/ExpressionsBot/MS-Lucidia-Voice-Gateway-MCP.git
cd MS-Lucidia-Voice-Gateway-MCP

2. Install dependencies:

npm install

3. Build the project:

npm run build

Usage

Testing Interface

1. Start the test server:

npm run test

2. Open http://localhost:3000 in your browser
3. Use the web interface to test TTS and STT capabilities

Available Tools

text_to_speech

Converts text to speech using Windows SAPI.

Parameters:

• text (required): The text to convert to speech
• voice (optional): The voice to use (e.g., “Microsoft David Desktop”)
• speed (optional): Speech rate from 0.5 to 2.0 (default: 1.0)

Example:

fetch('http://localhost:3000/tts', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    text: "Hello, this is a test",
    voice: "Microsoft David Desktop",
    speed: 1.0
  })
});

speech_to_text

Records audio and converts it to text using Windows Speech Recognition.

Parameters:

• duration (optional): Recording duration in seconds (default: 5, max: 60)

Example:

fetch('http://localhost:3000/stt', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    duration: 5
  })
}).then(response => response.json())
  .then(data => console.log(data.text));

Troubleshooting

1. Make sure Windows Speech Recognition is enabled:

   • Open Windows Settings
   • Go to Time & Language > Speech
   • Enable Speech Recognition

2. Check available voices:

   • Open PowerShell and run:

   Add-Type -AssemblyName System.Speech
   (New-Object System.Speech.Synthesis.SpeechSynthesizer).GetInstalledVoices().VoiceInfo.Name
   

3. Test speech recognition:

   • Open Speech Recognition in Windows Settings
   • Run through the setup wizard if not already done
   • Test that Windows can recognize your voice

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request

License

MIT