Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Pronunciation & Voice Coach

by JuhongParkversion 0.3.0i★ 3iRuns on your computerRepository ↗
Registry nameio.github.JuhongPark/pronunciation

How to install

What it does

Local MCP voice coach with English pronunciation, grammar, and fluency feedback.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Other

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity7/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness7/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score14/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Pronunciation & Voice Coach. Follow https://mcp.popnx.com/i/juhongpark-pronunciation.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Pronunciation & Voice Coach for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "pronunciation": { "command": "uvx", "args": [ "mcp-server-pronunciation" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Pronunciation & Voice Coach tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "pronunciation": {
          "command": "uvx",
          "args": [
            "mcp-server-pronunciation"
          ]
        }
      }
    }
  4. Quit Claude and open it again

  5. Try it

    Use Pronunciation & Voice Coach and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Pronunciation & Voice Coach or shows a Pronunciation & Voice Coach tool in the answer, you are connected

5 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • MCP_PRONUNCIATION_MODEL faster-whisper model size. Default: base.en. Options: tiny.en, base.en, small.en, medium.en, large-v3, large-v3-turbo.
  • HF_HUB_CACHE Override Hugging Face Hub cache directory where Whisper weights are stored.
  • MCP_PRONUNCIATION_PRELOAD Set to 0, false, no, or off to disable background Whisper model preload during registry inspection or Docker smoke tests.
  • MCP_PRONUNCIATION_AUDIO_RETENTION Temporary WAV retention policy. Use session to delete recordings when the server exits, or keep for manual inspection.
  • TORCH_HOME Override PyTorch cache directory for optional wav2vec2 forced-alignment weights.

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Pronunciation & Voice Coach yet

Pronunciation & Voice Coach runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Pronunciation & Voice Coach

  • Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • Install Python (uv) on your computer first (one time)
  • Install Python (uv) on your computer first (one time)
  • Install Python (uv) on your computer first (one time)

B · Others in Other that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Pronunciation & Voice Coach for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user pronunciation -- uvx mcp-server-pronunciation 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Pronunciation & Voice Coach tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user pronunciation -- uvx mcp-server-pronunciation
  4. Type /mcp in Claude Code

    You should see Pronunciation & Voice Coach listed as connected

  5. Try it

    Use Pronunciation & Voice Coach and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Pronunciation & Voice Coach or shows a Pronunciation & Voice Coach tool in the answer, you are connected

5 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • MCP_PRONUNCIATION_MODEL faster-whisper model size. Default: base.en. Options: tiny.en, base.en, small.en, medium.en, large-v3, large-v3-turbo.
  • HF_HUB_CACHE Override Hugging Face Hub cache directory where Whisper weights are stored.
  • MCP_PRONUNCIATION_PRELOAD Set to 0, false, no, or off to disable background Whisper model preload during registry inspection or Docker smoke tests.
  • MCP_PRONUNCIATION_AUDIO_RETENTION Temporary WAV retention policy. Use session to delete recordings when the server exits, or keep for manual inspection.
  • TORCH_HOME Override PyTorch cache directory for optional wav2vec2 forced-alignment weights.

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Pronunciation & Voice Coach for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "pronunciation": { "command": "uvx", "args": [ "mcp-server-pronunciation" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Pronunciation & Voice Coach tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Open the AI chat in Cursor in Agent mode

  4. Try it

    Use Pronunciation & Voice Coach and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Pronunciation & Voice Coach or shows a Pronunciation & Voice Coach tool in the answer, you are connected

5 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • MCP_PRONUNCIATION_MODEL faster-whisper model size. Default: base.en. Options: tiny.en, base.en, small.en, medium.en, large-v3, large-v3-turbo.
  • HF_HUB_CACHE Override Hugging Face Hub cache directory where Whisper weights are stored.
  • MCP_PRONUNCIATION_PRELOAD Set to 0, false, no, or off to disable background Whisper model preload during registry inspection or Docker smoke tests.
  • MCP_PRONUNCIATION_AUDIO_RETENTION Temporary WAV retention policy. Use session to delete recordings when the server exits, or keep for manual inspection.
  • TORCH_HOME Override PyTorch cache directory for optional wav2vec2 forced-alignment weights.

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Pronunciation & Voice Coach for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "pronunciation": { "type": "stdio", "command": "uvx", "args": [ "mcp-server-pronunciation" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Pronunciation & Voice Coach tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Open the AI chat in VS Code in Agent mode

  4. Try it

    Use Pronunciation & Voice Coach and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Pronunciation & Voice Coach or shows a Pronunciation & Voice Coach tool in the answer, you are connected

5 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • MCP_PRONUNCIATION_MODEL faster-whisper model size. Default: base.en. Options: tiny.en, base.en, small.en, medium.en, large-v3, large-v3-turbo.
  • HF_HUB_CACHE Override Hugging Face Hub cache directory where Whisper weights are stored.
  • MCP_PRONUNCIATION_PRELOAD Set to 0, false, no, or off to disable background Whisper model preload during registry inspection or Docker smoke tests.
  • MCP_PRONUNCIATION_AUDIO_RETENTION Temporary WAV retention policy. Use session to delete recordings when the server exits, or keep for manual inspection.
  • TORCH_HOME Override PyTorch cache directory for optional wav2vec2 forced-alignment weights.

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Pronunciation & Voice Coach💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user pronunciation -- uvx mcp-server-pronunciation

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "pronunciation": {
      "command": "uvx",
      "args": [
        "mcp-server-pronunciation"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "pronunciation": {
      "command": "uvx",
      "args": [
        "mcp-server-pronunciation"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "pronunciation": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-pronunciation"
      ]
    }
  }
}

Values you fill in

  • MCP_PRONUNCIATION_MODEL env
    faster-whisper model size. Default: base.en. Options: tiny.en, base.en, small.en, medium.en, large-v3, large-v3-turbo.
  • HF_HUB_CACHE env
    Override Hugging Face Hub cache directory where Whisper weights are stored.
  • MCP_PRONUNCIATION_PRELOAD env
    Set to 0, false, no, or off to disable background Whisper model preload during registry inspection or Docker smoke tests.
  • MCP_PRONUNCIATION_AUDIO_RETENTION env
    Temporary WAV retention policy. Use session to delete recordings when the server exits, or keep for manual inspection.
  • TORCH_HOME env
    Override PyTorch cache directory for optional wav2vec2 forced-alignment weights.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
62/wk
Connection
Runs on your computer
Latest versioni
0.3.0
Categoryi
Other
Published to registryi
May 3, 2026
Code last changedi
Oct 11, 2026
Maker
JuhongPark
Packages
pypi: mcp-server-pronunciation
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account JuhongPark, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 39 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for mcp-server-pronunciation@0.3.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/juhongpark-pronunciation.svg)](https://mcp.popnx.com/en/servers/juhongpark-pronunciation)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Otheri

  • More stars than 93% of the other 20693 servers in this category
  • Published to the registry more recently than 5% of the other 20693 servers in this category
  • Basic checks equal to or better than 99% of the other 20693 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Pronunciation & Voice Coach safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 39 days ago, and the latest version (0.3.0) reached the registry 7 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

by koala73Widely used★ 90.9KUpdated 3 days ago

Runs in the cloud✓ service owner · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

by openstatusHQWidely used★ 9.3KUpdated 2 months ago

Runs in the cloud✓ service owner · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

by JanDeDobbeleerWidely used★ 23.8K Stars for the whole repoUpdated 30 days ago

Runs in the cloud✓ service owner · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

by Klavis-AIGrowing★ 5.8KUpdated 14 months ago

Runs in the cloudRepo archived✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

by jitsucomWidely used★ 5.1KUpdated 4 months ago

Runs in the cloud✓ service owner · jitsu.com
Compared with similar ones
This one
Pronunciation & Voice Coach
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/44/44/41/44/4
LicenseMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

mcp-server-pronunciation

Accuracy and safety notice

This project is a local language-learning practice tool. It may contain bugs,

runtime errors, inaccurate transcripts, inaccurate pronunciation feedback, or

platform-specific recording issues. Pronunciation feedback is a coaching

signal, not a standardized-test, clinical, employment, or high-stakes

assessment. Review outputs carefully before relying on them. See

DISCLAIMER.md.

An MCP (Model Context Protocol) server that lets you talk to your MCP assistant by voice while getting English pronunciation, grammar, and fluency feedback in the same turn. Use it for casual voice chat with light coaching, or switch to drill mode when you want to practice a specific sentence.

Built for Codex CLI, Claude Desktop, Claude Code, Cursor, VS Code, and other MCP clients. Everything runs locally — audio is captured with your mic, transcribed by faster-whisper on-device, and never leaves your machine.

mcp-name: io.github.JuhongPark/pronunciation

Why

Voice MCP servers today treat speech as a typing replacement. English tutor MCP servers are text-only. This one combines the two: you speak freely, your assistant replies, and feedback on what you just said (pronunciation, grammar, fluency) surfaces inside the same tool call so the assistant can weave it into a natural reply — or stay out of the way when you're just chatting.

Features

  • Voice conversation with your MCP assistant. Speak, auto-stop on silence, then let the assistant read your transcript and respond.
  • Phoneme-level drill feedback (when a reference sentence is given): Needleman-Wunsch word alignment, per-word expected vs produced IPA, learner-profile hints, minimal-pair drills, and prosody checks (word stress, final-rise intonation, intra-clause pauses).
  • Extensible learner-profile support: the current rule pack includes Korean-L1 pronunciation-pattern hints and Korean-language tips. Contributions for additional L1 profiles are welcome.
  • Whisper-bias mitigation via optional [phoneme] extra: wav2vec2 CTC forced alignment verifies whether the user actually produced each reference word, so rare proper nouns and domain-specific terms that Whisper rewrites toward more common alternatives no longer surface as mispronunciations.
  • Inline English feedback in conversation: pronunciation, grammar (common irregular-verb errors), and fluency (pace + long pauses).
  • Drill mode (practice, quick_practice, retry) for focused sentence practice.
  • Local-only: Whisper model runs on your machine, audio never leaves it.
  • Cross-platform: macOS, Linux, Windows, and WSL2 (recording auto-routes through Windows).
  • Fast startup: lazy imports + background model pre-load keep the MCP handshake under a second.

Requirements

  • Python 3.11+
  • A working microphone
  • ~150 MB disk space for the default Whisper model (base.en)
  • Additional ~360 MB if you install the optional [phoneme] extra (wav2vec2 weights for forced alignment)
  • MCP spec: targets 2025-06-18 via the official Python SDK (mcp>=1.2)

Installation

Stable release

Install the latest stable release:

uvx mcp-server-pronunciation

For pip users:

pip install mcp-server-pronunciation

To pin this release explicitly:

uvx mcp-server-pronunciation@0.3.0

Run doctor before relying on the server in a live session:

mcp-server-pronunciation doctor
General install commands
# Recommended: uvx (no global install, cached between runs)

uvx mcp-server-pronunciation

Or install as a uv tool

uv tool install mcp-server-pronunciation

Or pip

pip install mcp-server-pronunciation

Optional: forced-alignment upgrade for Whisper-bias mitigation + tighter

phoneme-level feedback. Adds ~200 MB of torch CPU wheels.

pip install 'mcp-server-pronunciation[phoneme]'

Linux: install PortAudio first

sounddevice ships PortAudio inside the wheel on macOS and Windows, but on Linux you need the system library:

# Debian / Ubuntu

sudo apt-get install libportaudio2

Fedora / RHEL

sudo dnf install portaudio

Arch

sudo pacman -S portaudio

PipeWire-only systems may also need

sudo apt-get install pipewire-alsa

First-time check

Before wiring the server into an MCP client, run the preflight:

uvx mcp-server-pronunciation doctor

Optional — pre-download the Whisper model (~150 MB) so the first call is instant:

uvx mcp-server-pronunciation pull-model base.en

Add to your MCP client

Codex CLI
codex mcp add pronunciation -- uvx mcp-server-pronunciation
Claude Code
claude mcp add pronunciation -- uvx mcp-server-pronunciation
Claude Desktop

Edit claude_desktop_config.json:

{

"mcpServers": { "pronunciation": { "command": "uvx", "args": ["mcp-server-pronunciation"] } } }

On macOS, if Claude Desktop can't find uvx (spawn uvx ENOENT), use an absolute path. Find it with which uvx in your terminal.

Cursor

Add to ~/.cursor/mcp.json:

{

"mcpServers": { "pronunciation": { "command": "uvx", "args": ["mcp-server-pronunciation"] } } }

VS Code (with MCP support)

Add to .vscode/mcp.json or your user settings:

{

"servers": { "pronunciation": { "type": "stdio", "command": "uvx", "args": ["mcp-server-pronunciation"] } } }

Usage Examples

1. Voice chat with feedback

You: "Let's have a voice chat. I'll ask you about the weekend. Use the converse tool."

Assistant (calls converse): *records your speech, transcribes it, notes that you said "buyed" instead of "bought"*

Assistant: "Oh nice — what kind of apples did you buy? And by the way, the past tense of 'buy' is 'bought' — small thing, but I noticed it."

2. Drill a specific sentence

You: "Give me a sentence to practice with 'th' sounds."

Assistant (calls suggest_sentence with focus=th): "Try this: *The three brothers thought thoroughly about their future.*"

You: "Record me reading it."

Assistant (calls practice with that reference): *returns an alignment table (match / sub / ins / del) with per-word acoustic confidence when the [phoneme] extra is installed, phoneme-level issues with expected vs produced IPA, learner-profile hints when applicable, minimal-pair drills, and prosody notes (word stress, final-rise intonation, intra-clause pauses).*

3. Retry after feedback

You: "Let me try again."

Assistant (calls retry): *re-records the same target sentence and compares*

Tools

ToolPurpose
`converse`Primary. Record + transcribe + quick feedback + assistant guidance for natural voice-chat-with-coaching.
practiceDrill mode: record user reading a specific reference sentence, return detailed assessment.
quick_practicePick a random sentence (by phoneme focus + difficulty) and drill it.
retryRe-record the last sentence and compare the new attempt against the previous one.
open_voice_panelOpen the MCP Apps voice panel when the client supports embedded UI.
analyze_uploaded_audioAnalyze WAV audio uploaded by the voice panel and store it as the latest voice capture.
start_voice_captureStart recording in the background and return a session id immediately.
voice_capture_statusCheck whether a background capture is recording, analyzing, done, cancelled, or failed.
wait_for_voice_captureWait for a background capture to finish and return transcript + feedback.
latest_voice_captureReturn the most recent background voice capture result.
cancel_voice_captureMark a background capture as cancelled before analysis starts.
suggest_sentenceReturn a practice sentence without recording.
recordRecord audio and save a WAV file (raw, no analysis).
assessAssess the last recording (or a specified WAV) without re-recording. When given a reference, runs the full drill pipeline (alignment, phoneme diff, learner-profile hints, prosody).
check_micList available audio input devices.

Tools that assess speech also return structured MCP output with transcript, clarity_pct, speaking_rate_wpm, top_issue, next_action, retry_comparison, the full machine-readable assessment, and the rendered report_markdown. MCP clients can use the structured result to offer a retry, surface the top issue, or build a richer practice UI without parsing Markdown.

Visible voice-capture workflow

For MCP clients without an embedded voice UI, use the background capture tools to keep the user informed:

start_voice_capture(duration=8, mode="conversation")

voice_capture_status(session_id) wait_for_voice_capture(session_id, timeout=30) latest_voice_capture()

The status response includes recording, analyzing, done, error, or cancelled, plus elapsed time, transcript, clarity, speaking rate, feedback markdown, and the full structured assessment when available. On WSL2, keep duration short because PowerShell recording may wait for the full requested duration before analysis begins.

MCP Apps voice panel

Clients that support MCP Apps can call open_voice_panel to render the ui://pronunciation/voice-panel resource. The panel requests browser microphone access, records locally in the browser, uploads a WAV clip through analyze_uploaded_audio, and displays the returned transcript and feedback. Uploaded audio must be a readable 16-bit PCM RIFF/WAVE file with mono or stereo audio at 8-48 kHz, no larger than 20 MB and no longer than 120 seconds.

The uploaded clip is stored in the same voice session registry as MCP-only recordings, so assistants can call latest_voice_capture after the panel finishes and respond to both the development note and the pronunciation feedback. Clients without MCP Apps support should use the visible voice-capture workflow above.

Prompt Shortcuts

MCP clients that expose server prompts can start common workflows directly:

PromptPurpose
start_voice_chatStart a local voice conversation with light feedback.
daily_practiceRun a short suggested-sentence practice loop.
practice_focusStart a drill for a chosen focus and difficulty.
troubleshoot_micInspect microphone devices and recording settings.

Configuration

Whisper model

Set MCP_PRONUNCIATION_MODEL to pick a different model size:

# Default — fast, English-only (~150 MB)

export MCP_PRONUNCIATION_MODEL=base.en

Smaller / faster (~75 MB)

export MCP_PRONUNCIATION_MODEL=tiny.en

More accurate (~470 MB)

export MCP_PRONUNCIATION_MODEL=small.en

Multilingual options (larger)

export MCP_PRONUNCIATION_MODEL=small export MCP_PRONUNCIATION_MODEL=medium

Available: tiny, tiny.en, base, base.en, small, small.en, medium, medium.en, large-v3, large-v3-turbo. For English-only use, the .en variants are faster and more accurate at a given size.

GPU (CUDA 12 + cuDNN 9) is auto-detected when available; otherwise runs on CPU with int8 quantization.

Cache location

By default Whisper weights are cached in ~/.cache/huggingface/hub/. Override with HF_HUB_CACHE:

export HF_HUB_CACHE=/path/to/cache
Startup preload

By default the server preloads the Whisper model in the background after the MCP handshake starts. Set MCP_PRONUNCIATION_PRELOAD=0 for registry inspection, Docker smoke tests, or other environments that only need tool

Only the beginning is shown; read the rest in the repo