# transcript-tts

A minimal [MCP](https://modelcontextprotocol.io) server that converts text/transcripts into
MP3 audio using Microsoft Edge's free neural text-to-speech voices ([`edge-tts`](https://github.com/rany2/edge-tts)).
No API key, no account, no usage cap — it's an unofficial use of the same TTS service behind
Edge's "Read Aloud" feature.

## Tools

- **`text_to_speech(text, voice="en-US-AriaNeural", rate="+0%", volume="+0%", pitch="+0Hz", filename=None)`**
  Synthesizes `text` to an MP3 file. Returns `{"audio_path": ..., "voice": ...}`.
  Files are saved to `~/tts-output/` by default (override with `TRANSCRIPT_TTS_OUTPUT_DIR`).

- **`list_voices(locale_prefix=None)`**
  Lists available voices, optionally filtered by locale (e.g. `"en-US"`, `"ja"`, `"en-GB"`).

## Setup

Requires [`uv`](https://docs.astral.sh/uv/).

```bash
git clone https://github.com/ShevinuM/transcript-tts.git
cd transcript-tts
uv sync
```

Register with Claude Code:

```bash
claude mcp add --scope user transcript-tts -- \
  /path/to/transcript-tts/.venv/bin/python /path/to/transcript-tts/server.py
```

Or add it manually to your MCP client config (e.g. `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "transcript-tts": {
      "command": "/path/to/transcript-tts/.venv/bin/python",
      "args": ["/path/to/transcript-tts/server.py"]
    }
  }
}
```

## Environment variables

- `TRANSCRIPT_TTS_OUTPUT_DIR` — where MP3s are saved (default: `~/tts-output`)
- `TRANSCRIPT_TTS_VOICE` — default voice short name (default: `en-US-AriaNeural`)

## Notes

Requires `mcp[cli]>=2.0.0` — the MCP Python SDK renamed `FastMCP` to `MCPServer` in its 2.0
release, so this won't work against older `mcp` SDK versions without adjusting the import in
`server.py`.