22
33A real-time text-to-speech MCP App with karaoke-style text highlighting, powered by [ Kyutai's Pocket TTS] ( https://github.com/kyutai-labs/pocket-tts ) .
44
5+ ![ Screenshot] ( screenshot.png )
6+
57## MCP Client Configuration
68
79Add to your MCP client configuration (stdio transport):
@@ -47,35 +49,31 @@ This example showcases several MCP App capabilities:
4749
4850## Prerequisites
4951
50- - [ uv] ( https://docs.astral.sh/uv/getting-started/installation/ ) - fast Python package manager
51- - A CUDA GPU (recommended) or CPU with sufficient RAM (~ 2GB for model)
52+ - [ uv] ( https://docs.astral.sh/uv/ ) - fast Python package manager
5253
5354## Quick Start
5455
55- The server is a single self-contained Python file that can be run directly with ` uv ` :
56+ The server is a single self-contained Python file that can be run directly from GitHub :
5657
5758``` bash
58- # Run directly (uv auto-installs dependencies)
59- uv run examples/say-server/server.py
59+ # Run directly from GitHub (uv auto-installs dependencies)
60+ uv run https://raw.githubusercontent.com/modelcontextprotocol/ext-apps/main/ examples/say-server/server.py
6061```
6162
6263The server will be available at ` http://localhost:3109/mcp ` .
6364
6465## Running with Docker
6566
66- Run directly from GitHub using the official ` uv ` Docker image. Mount your HuggingFace cache to avoid re-downloading the model :
67+ Run directly from GitHub using the official ` uv ` Docker image:
6768
6869``` bash
6970docker run --rm -it \
7071 -p 3109:3109 \
71- -v ~ /.cache/huggingface:/root/.cache/huggingface \
72- -e HF_HOME=/root/.cache/huggingface \
72+ -v ~ /.cache/huggingface-docker-say-server:/root/.cache/huggingface \
7373 ghcr.io/astral-sh/uv:debian \
7474 uv run https://raw.githubusercontent.com/modelcontextprotocol/ext-apps/main/examples/say-server/server.py
7575```
7676
77- For GPU support, add ` --gpus all ` (requires [ NVIDIA Container Toolkit] ( https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html ) ).
78-
7977## Usage
8078
8179### With Claude Desktop
@@ -87,8 +85,11 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
8785 "mcpServers" : {
8886 "say" : {
8987 "command" : " uv" ,
90- "args" : [" run" , " server.py" , " --stdio" ],
91- "cwd" : " /path/to/examples/say-server"
88+ "args" : [
89+ " run" ,
90+ " https://raw.githubusercontent.com/modelcontextprotocol/ext-apps/main/examples/say-server/server.py" ,
91+ " --stdio"
92+ ]
9293 }
9394 }
9495}
0 commit comments