# CantoneseTTS.com: Hong Kong Cantonese Voiceover & SRT MCP

CantoneseTTS.com: Hong Kong Cantonese Voiceover & SRT MCP is a Claude Code MCP server that turns written Chinese and Hong Kong Cantonese scripts into voiceovers with SRT and VTT subtitles. An agent can choose a voice and set its emotion.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: cantonesetts
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cantonesetts/cantonesetts-mcp
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/cantonesettscom-hong-kong-cantonese-voiceover-srt-mcp

## What it does

The server generates spoken Hong Kong Cantonese and Cantonese-English speech, then returns MP3 audio alongside timed SRT and VTT subtitles. Agents can also list available voices and check the character wallet balance. The voice catalogue includes 30 options and seven emotions; playback speed, pitch, and volume can be adjusted.

A CantoneseTTS.com API key is required. The remote connection uses HTTP at `https://cantonesetts.com/api/mcp`; the local option runs through `npx` and requires Node.js 18 or later. Synthesis deducts characters from the wallet and returns the remaining balance with the audio and subtitle links.

## Requirements
- Remote server: `https://cantonesetts.com/api/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http cantonesettscom-hong-kong-cantonese-voiceover-srt-mcp https://cantonesetts.com/api/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add cantonesettscom-hong-kong-cantonese-voiceover-srt-mcp --url https://cantonesetts.com/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cantonesettscom-hong-kong-cantonese-voiceover-srt-mcp": {
            "url": "https://cantonesetts.com/api/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cantonesettscom-hong-kong-cantonese-voiceover-srt-mcp": {
            "type": "http",
            "url": "https://cantonesetts.com/api/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http cantonesettscom-hong-kong-cantonese-voiceover-srt-mcp https://cantonesetts.com/api/mcp
```

## When to use it
- create a Hong Kong Cantonese voiceover
- get timed SRT and VTT subtitles with audio
- choose a voice and emotion for speech
- check the remaining character wallet balance

## Example prompts
- Turn this script into a Hong Kong Cantonese voiceover and return SRT and VTT subtitles.
- Choose a voice for this promo and generate the speech with a happy delivery.
- Check the CantoneseTTS.com character wallet balance.

## Similar
- [Hong Kong Company Registry & Due Diligence (86hc.com)](https://affpapa.org/en/nevibecode/mcp/hong-kong-company-registry-due-diligence-86hccom.md) — MCP server · ★ 2 repo stars
- [ipollowork-video-voiceover](https://affpapa.org/en/nevibecode/skills/ipollowork-video-voiceover.md) — skill · ★ 7523 repo stars
- [ai-voiceover](https://affpapa.org/en/nevibecode/skills/ai-voiceover.md) — skill · 1300 installs
- [srt](https://affpapa.org/en/nevibecode/skills/srt.md) — skill · ★ 40 repo stars
- [media-use](https://affpapa.org/en/nevibecode/skills/media-use.md) — skill · 1500000 installs
- [import-srt-captions](https://affpapa.org/en/nevibecode/rules/import-srt-captions.md) — rule · ★ 849 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
