Skip to content

Commit 24f4392

Browse files
committed
Merge remote-tracking branch 'origin/ochafik/fix-say-server-readme' into ochafik/readme-mcp-config
# Conflicts: # examples/say-server/README.md
2 parents cba7b71 + 198a1be commit 24f4392

File tree

1 file changed

+13
-12
lines changed

1 file changed

+13
-12
lines changed

examples/say-server/README.md

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22

33
A 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

79
Add 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

6263
The 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
6970
docker 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

Comments
 (0)