Text To Speech (Windows)

🚀 MS-Lucidia-Voice-Gateway-MCP

This is a Model Context Protocol (MCP) server that utilizes the built - in Windows voice services, offering Text - to - Speech (TTS) and Speech - to - Text (STT) capabilities. The server invokes Windows' native Speech API (SAPI) through PowerShell commands, eliminating the need for external APIs or services.

🚀 Quick Start

This server allows you to quickly implement TTS and STT features using Windows' native voice services. You can start testing through the simple web interface after installation.

✨ 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
• Invokes native Windows features

📦 Installation

Prerequisites

• Windows 10/11 operating system with speech recognition enabled
• Node.js 16+
• PowerShell

Steps

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 Examples

Basic Usage

Test Interface

1. Start the test server:

npm run test

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

Advanced Usage

text_to_speech

Convert text to speech using Windows SAPI voices.

Parameters:

• text (required): The text to be converted to speech
• voice (optional): The name of the voice to use (e.g., "Microsoft David Desktop")
• speed (optional): The speech speed, ranging 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

Record audio and convert it to text using Windows speech recognition.

Parameters:

• duration (optional): The recording duration in seconds (default: 5, maximum: 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));

📚 Documentation

Troubleshooting

1. Ensure that Windows speech recognition is enabled:

   • Open Windows Settings
   • Navigate 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
   • If not completed, run the setup wizard
   • Test if Windows can recognize your voice

Contribution

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the remote repository
5. Submit a pull request

📄 License

[Add license information here]