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:

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:

{
  "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