mcp-tts-server

mcp-tts-server

1
communication

This project is a Text-to-Speech server implementing the Model Context Protocol to generate realistic audio using the Groq API. Key features include support for multiple audio formats and an MCP-accessible speech generation tool.

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.