mcp-tts-server

This project provides a Text-to-Speech (TTS) server based on the Model Context Protocol (MCP), utilizing the Groq API for speech generation.

Features

- Implements an MCP server for TTS functionality.
- Connects to the Groq API (https://api.groq.com/openai/v1/audio/speech) for generating lifelike audio from text.
- Provides a generate_speech tool accessible via the MCP protocol.
- Supports multiple audio output formats (wav, mp3, aac, opus, flac).
- Uses @tropicbliss/symphonia to play the generated audio directly on the server machine (optional).
- Requires a Groq API key set as an environment variable (GROQ_API_KEY).

Installation

To install dependencies:

bun install

Running the Server on MCP Client

To run the server using the stdio transport:

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

Project Structure

- src/server.ts: Defines the core MCP server logic, including the generate_speech tool and interaction with the Groq API.
- src/cli.ts: Provides a command-line interface to run the MCP server over stdio.

This project was created using bun init in bun v1.2.7. Bun is a fast all-in-one JavaScript runtime.