mcp-tts-server

What is mcp-tts-server?

mcp-tts-server is a Text-to-Speech (TTS) server built on the Model Context Protocol (MCP). It uses the Groq API to generate lifelike audio from text and is intended for use with MCP‑compatible clients.

How to use mcp-tts-server?

Install dependencies with bun install, then add the server to your MCP client configuration as a stdio transport. Provide your Groq API key via the GROQ_API_KEY environment variable. The server exposes a generate_speech tool that can be invoked through the MCP protocol.

Key features of mcp-tts-server

• Implements an MCP server for TTS functionality.
• Connects to the Groq API for speech generation.
• Provides a generate_speech tool via MCP.
• Supports multiple audio formats: wav, mp3, aac, opus, flac.
• Optional local playback using @tropicbliss/symphonia.
• Requires a Groq API key set as GROQ_API_KEY.

Use cases of mcp-tts-server

• Integrate text‑to‑speech into any MCP‑compatible application.
• Generate audio files in various formats for downstream use.
• Automate speech generation in workflows managed by an MCP client.

FAQ from mcp-tts-server

What runtime is required to run mcp-tts-server?

The server was created with Bun (v1.2.7) and uses bunx to execute.

How do I provide my Groq API key?

Set the environment variable GROQ_API_KEY in the server configuration.

What audio formats are supported?

The server supports wav, mp3, aac, opus, and flac.

Can the server play audio directly on the machine?

Yes, optional playback is available using the @tropicbliss/symphonia library.

How do I configure the server in an MCP client?

Add the following JSON to your MCP client configuration, replacing the API key with your own:

{
  "mcpServers": {
    "mcp-tts-server": {
      "command": "bunx",
      "args": ["--bun", "mcp-tts-server"],
      "env": {
        "GROQ_API_KEY": "gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}