modelcontextprotocol/ext-apps
Watch
1
0
Fork
You've already forked ext-apps
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

fix(say-server): clean up README

Browse source 
- Add screenshot reference
- Remove GPU prerequisite (not needed, wasn't requested)
- Use GitHub raw URLs instead of local file paths
- Simplify Docker section
- Fix Claude Desktop config to use remote URL
This commit is contained in:
Olivier Chafik 2026-01-20 01:08:01 +00:00
commit def51a70ad
No known key found for this signature in database
1 changed files with 12 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

23
examples/say-server/README.md
View file

@ -2,6 +2,8 @@
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). 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).
![Screenshot](screenshot.png)
## MCP App Features Demonstrated ## MCP App Features Demonstrated
This example showcases several MCP App capabilities: This example showcases several MCP App capabilities:
@ -26,35 +28,31 @@ This example showcases several MCP App capabilities:
## Prerequisites ## Prerequisites
- [uv](https://docs.astral.sh/uv/getting-started/installation/) - fast Python package manager - [uv](https://docs.astral.sh/uv/) - fast Python package manager
- A CUDA GPU (recommended) or CPU with sufficient RAM (~2GB for model)
## Quick Start ## Quick Start
The server is a single self-contained Python file that can be run directly with `uv`: The server is a single self-contained Python file that can be run directly from GitHub:
```bash ```bash
# Run directly (uv auto-installs dependencies) # Run directly from GitHub (uv auto-installs dependencies)
uv run examples/say-server/server.py uv run https://raw.githubusercontent.com/modelcontextprotocol/ext-apps/main/examples/say-server/server.py
``` ```
The server will be available at `http://localhost:3109/mcp`. The server will be available at `http://localhost:3109/mcp`.
## Running with Docker ## Running with Docker
Run directly from GitHub using the official `uv` Docker image. Mount your HuggingFace cache to avoid re-downloading the model: Run directly from GitHub using the official `uv` Docker image:
```bash ```bash
docker run --rm -it \ docker run --rm -it \
-p 3109:3109 \ -p 3109:3109 \
-v ~/.cache/huggingface:/root/.cache/huggingface \ -v ~/.cache/huggingface:/root/.cache/huggingface \
-e HF_HOME=/root/.cache/huggingface \
ghcr.io/astral-sh/uv:debian \ ghcr.io/astral-sh/uv:debian \
uv run https://raw.githubusercontent.com/modelcontextprotocol/ext-apps/main/examples/say-server/server.py uv run https://raw.githubusercontent.com/modelcontextprotocol/ext-apps/main/examples/say-server/server.py
``` ```
For GPU support, add `--gpus all` (requires [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html)).
## Usage ## Usage
### With Claude Desktop ### With Claude Desktop
@ -66,8 +64,11 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
"mcpServers": { "mcpServers": {
"say": { "say": {
"command": "uv", "command": "uv",
"args": ["run", "server.py", "--stdio"], "args": [
"cwd": "/path/to/examples/say-server" "run",
"https://raw.githubusercontent.com/modelcontextprotocol/ext-apps/main/examples/say-server/server.py",
"--stdio"
]
} }
} }
} }