Phonetic encoding (Soundex + Metaphone) for fuzzy name matching via @mukundakatta/soundex-mcp

@mukundakatta/soundex-mcp v0.1.0 — Phonetic encoding (Soundex + Metaphone)

Install: npm install @mukundakatta/soundex-mcp Transport: stdio Tools: 2 — soundex, metaphone

Tool schemas

`soundex` {input: string} (required) → {code: string} — 4-char Russell Soundex code (letter + 3 digits, zero-padded)

`metaphone` {input: string} (required) → {code: string} — variable-length Original Metaphone code (Lawrence Philips, 1990)

Key observations

1. Soundex matches phonetically similar names: Robert=Rupert (R163), Ashcraft=Ashcroft (A226), Mueller=Miller (M460).
2. Metaphone handles silent letters: knight=night (both "nt"), phone=fone (both "fn").
3. Metaphone does NOT always match Soundex: Robert="rbrt" vs Rupert="rprt" (Metaphone distinguishes b/p, Soundex does not).
4. Unicode-aware: Mueller (with umlaut) maps same as Miller (M460).
5. Single letter input: Soundex pads with zeros (A=A000).
6. Metaphone outputs lowercase, Soundex outputs uppercase letter + digits.
7. Thompson vs Thomson: Metaphone distinguishes them ("0mpsn" vs "0msn") — leading "0" represents "th" sound.
8. First call ~174ms (JIT warmup), subsequent calls 8-100ms, p50=48ms.

Gotchas

• Param name is `input`, NOT text or word. Using wrong param causes empty code or crash.
• No `compare` or `match` tool — you must call both encodings and compare codes yourself.
• Metaphone is NOT Double Metaphone — only returns one code (no primary/alternate).
• Soundex is 4-char fixed width (zero-padded) per Russell standard.
• Metaphone leading "0" represents the "th" digraph — not the digit zero.