ms-tts

MCP Text-to-Speech Server

Model Context Protocol server for text-to-speech synthesis using Azure Speech Services.

Features

• 🎵 High-Quality Speech: Azure Neural voices with natural sound
• 🌍 6 Languages: English, Finnish, Spanish, German, French, Swedish
• 🗣️ Smart Voice Selection: Auto-select optimal voices or specify manually
• 📊 Performance Metrics: Synthesis timing and audio stats
• 🔧 MCP Compatible: Works with Claude Desktop, VS Code, other MCP clients

Supported Voices

| Language | Default Voice | Alternatives | |----------|---------------|--------------| | English (en-US) | en-US-RyanMultilingualNeural | en-US-JennyMultilingualNeural, en-US-AndrewMultilingualNeural | | Finnish (fi-FI) | en-US-RyanMultilingualNeural | en-US-JennyMultilingualNeural, fi-FI-SelmaNeural, fi-FI-NooraNeural | | Spanish (es-ES) | es-ES-AlvaroNeural | es-ES-ElviraNeural | | German (de-DE) | de-DE-ConradNeural | de-DE-KatjaNeural | | French (fr-FR) | fr-FR-DeniseNeural | fr-FR-HenriNeural | | Swedish (sv-SE) | sv-SE-MattiasNeural | sv-SE-SofieNeural |

Quick Start

# 1. Install
npm install

# 2. Configure (copy from parent or create .env)
cp ../.env .env

# 3. Test
npm run test:basic

# 4. Start
npm start

Required .env: ``env AZURE_SPEECH_KEY=your-key AZURE_SPEECH_REGION=westeurope ``

MCP Integration

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "audio-tts": {
      "command": "node",
      "args": ["/path/to/mcp-server/mcp-server.mjs"],
      "env": {"AZURE_SPEECH_KEY": "your-key", "AZURE_SPEECH_REGION": "westeurope"}
    }
  }
}

VS Code

Use included .vscode/mcp.json or install MCP extension.

Usage

Natural language: "Convert to Finnish speech: Hei kaikki, olen Jenny."

Direct tool call: ``json { "tool": "synthesize_speech", "parameters": { "sentence": "Hei kaikki, olen Jenny ja puhun suomea.", "language": "fi-FI", "voice": "en-US-JennyMultilingualNeural" } } ``

Tool Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | sentence | ✅ | Text to convert (1-1000 chars) | | language | ✅ | Language code (en-US, fi-FI, es-ES, de-DE, fr-FR, sv-SE) | | voice | ❌ | Specific voice (uses language default if not specified) |

Output

Audio saved to ./audio/mcp-generated/ as: `` mcp-tts-fi_FI-en-US-JennyMultilingualNeural-2025-08-17T16-30-45-123Z.wav ``

Returns: file path, voice used, performance metrics (synthesis time, duration, etc.)

Troubleshooting

Server won't start: Check Azure credentials in .env, ensure Node.js 16+, run npm install

No audio output: Verify output directory exists, check Azure quota/billing, confirm supported language

Voice issues: Use exact voice names from table above, try language default, check Azure region support

Debug mode: DEBUG=* npm start

Requirements

• Node.js 16+
• Azure Speech Services API key
• MCP-compatible client (Claude Desktop, VS Code with MCP extension)

---

Built with Model Context Protocol for universal AI integration