hsk-mcp
A remote Model Context Protocol (MCP) server that gives AI assistants structured access to the complete HSK Chinese vocabulary dataset. It exposes 13 tools and 8 resources covering word lookup, transcription conversion, frequency analysis, study set generation, and more. 11,470 headwords / 12,623 pronunciation forms / HSK 1-7 (new 3.0) + HSK 1-6 (old 2.0)
How to connect
https://hsk-mcp--kuibin-dev.run.tools
tools/list returns the expected tools before relying on them in production.Tools
(13)-
hsk_lookupLook up a Chinese word by simplified characters, traditional characters, or pinyin. Returns all pronunciation forms with meanings, frequency rank, and HSK level. Pinyin input accepts tone marks (hǎo), tone numbers (hao3), or plain ASCII (hao). Meanings are in English.
-
hsk_frequencyGet the frequency ranking and usage statistics for a Chinese word. Returns the word's rank among HSK vocabulary (1 = most frequent), raw frequency score, rarity class, and HSK level.
-
hsk_convert_scriptConvert a Chinese word to all 5 transcription systems: pinyin (tone marks), numeric (tone numbers), Wade-Giles, Bopomofo/Zhuyin, and Gwoyeu Romatzyh. Returns all systems for every pronunciation form.
-
hsk_classifierFind the measure word (classifier / 量词) for a Chinese noun. Returns all classifiers associated with the word. Empty list if no classifiers exist in the dataset.
-
hsk_convert_charactersConvert a Chinese word between simplified and traditional characters. Accepts either script and returns both with pinyin and meanings. Covers 11,470 HSK words. Meanings are in English.
-
hsk_search_meaningSearch for HSK words by English meaning using full-text search. Each result includes simplified characters, pinyin, all transcription systems, meanings, classifiers, and HSK levels. Ordered by relevance. Paginated (20 per page).
-
hsk_words_by_radicalFind all HSK words sharing a given radical (部首). Each word includes simplified/traditional characters, pinyin, part of speech, meanings, radical, frequency rank, and HSK levels. Ordered by frequency. Paginated (20 per page).
-
hsk_polyphonesList Chinese characters with multiple pronunciations (多音字) in HSK vocabulary. Each result includes all pronunciation forms with pinyin, meanings, and part of speech. Ordered by frequency. Paginated (20 per page).
-
hsk_homophonesFind HSK words sharing the same pinyin pronunciation (homophones). Useful for drilling tone-pair distinctions. Each result includes simplified characters, pinyin, all transcription systems, meanings, and HSK levels. Paginated (20 per page).
-
hsk_build_study_setBuild a study set of HSK words for a given level, ordered by frequency (most common first). Each word includes simplified/traditional characters, pinyin, part of speech, meanings, radical, frequency rank, and HSK levels. Paginated (20 per page).
-
hsk_suggest_nextSuggest the next words to learn at a given HSK level, excluding words already known. Each word includes simplified/traditional characters, pinyin, part of speech, meanings, radical, frequency rank, and HSK levels. Ordered by frequency (most useful first). Paginated (20 per page).
-
hsk_compareCompare 2-5 Chinese words side by side. Each word shows simplified/traditional characters, pinyin, part of speech, frequency rank, HSK levels, radical, all transcription systems, and meanings.
-
hsk_diffCompare two HSK levels to see vocabulary overlap and differences. Shows words exclusive to each level and words shared by both. Useful for comparing old (HSK 2.0) vs new (HSK 3.0) standards.