speaches-mcp

An MCP (Model Context Protocol) server that exposes speaches as transcribe_audio and text_to_speech tools.

Speaches is a local, OpenAI API-compatible server for speech-to-text (via faster-whisper) and text-to-speech (via Kokoro/Piper). This MCP server lets AI assistants like Claude use it directly.

Tools

transcribe_audio

Transcribe an audio file using your speaches instance.

text_to_speech

Convert text to speech and save to a file.

Usage

With Docker + Supergateway (SSE transport)

This exposes the MCP server over SSE on port 8010, suitable for remote clients.

docker compose up --build

Then connect your MCP client to http://localhost:8010/sse.

Standalone (stdio transport)

Build the image:

docker build -t speaches-mcp .

Run it:

docker run --rm -i \
  -e SPEACHES_URL=http://your-speaches-host:8000 \
  speaches-mcp

For Claude Desktop, add to your config:

{
  "mcpServers": {
    "speaches": {
      "command": "docker",
      "args": ["run", "--rm", "-i",
        "-e", "SPEACHES_URL=http://your-speaches-host:8000",
        "speaches-mcp"
      ]
    }
  }
}

Environment Variables

Downloading Models

Before transcribing, make sure you've downloaded models into speaches:

# Speech-to-text
curl http://your-speaches-host:8000/v1/models/Systran/faster-whisper-large-v3 -X POST

# Text-to-speech
curl http://your-speaches-host:8000/v1/models/speaches-ai/Kokoro-82M-v1.0-ONNX -X POST

License

MIT