
hsk-mcp
Gives Claude structured access to the complete HSK Chinese vocabulary dataset with 11,470 headwords across HSK 1-9 (new 3.0) and HSK 1-6 (old 2.0). You get 13 tools for word lookup, frequency ranking, pinyin/Wade-Giles/Bopomofo conversion, homophone and polyphonic character search, radical-based filtering, and study set generation. The compare tool lets you diff vocabulary across HSK levels or put multiple words side by side with their frequency ranks and meanings. Runs as a public HTTP endpoint at hsk-mcp.linsnotes.com with no auth required. Useful for building Chinese learning tools, generating flashcard decks, or having Claude answer detailed HSK vocabulary questions without hallucinating pronunciations or level assignments.
- GitHub stars
- 1
- tools
- 13
- transport
- HTTP
- last updated
- Apr 13, 2026
Tools
13 toolsPublic tool metadata for what this MCP can expose to an agent.
hsk_lookupLook up a word by simplified, traditional, or pinyin. Returns all forms with meanings, frequency, and HSK level.
Look up a word by simplified, traditional, or pinyin. Returns all forms with meanings, frequency, and HSK level.
No parameter schema in public metadata yet.
hsk_frequencyGet frequency ranking and rarity class for a word (1 = most common).
Get frequency ranking and rarity class for a word (1 = most common).
No parameter schema in public metadata yet.
hsk_convert_scriptShow a word in all 5 transcription systems: pinyin, numeric, Wade-Giles, Bopomofo, Romatzyh.
Show a word in all 5 transcription systems: pinyin, numeric, Wade-Giles, Bopomofo, Romatzyh.
No parameter schema in public metadata yet.
hsk_classifierFind the measure word(s) for a noun.
Find the measure word(s) for a noun.
No parameter schema in public metadata yet.
hsk_convert_charactersConvert between simplified and traditional characters. Returns both scripts with pinyin and meanings.
Convert between simplified and traditional characters. Returns both scripts with pinyin and meanings.
No parameter schema in public metadata yet.
hsk_search_meaningFull-text search by English meaning, ranked by relevance.
Full-text search by English meaning, ranked by relevance.
No parameter schema in public metadata yet.
hsk_words_by_radicalFind all words sharing a radical, ordered by frequency.
Find all words sharing a radical, ordered by frequency.
No parameter schema in public metadata yet.
hsk_polyphonesList characters with multiple pronunciations (多音字).
List characters with multiple pronunciations (多音字).
No parameter schema in public metadata yet.
hsk_homophonesFind words sharing the same pinyin (homophones). Accepts tone marks, numbers, or plain ASCII.
Find words sharing the same pinyin (homophones). Accepts tone marks, numbers, or plain ASCII.
No parameter schema in public metadata yet.
hsk_build_study_setBuild a study set for a level, ordered by frequency.
Build a study set for a level, ordered by frequency.
No parameter schema in public metadata yet.
hsk_suggest_nextSuggest next words to learn, excluding words you already know.
Suggest next words to learn, excluding words you already know.
No parameter schema in public metadata yet.
hsk_compareCompare 2-5 words side by side (frequency, levels, meanings, radicals).
Compare 2-5 words side by side (frequency, levels, meanings, radicals).
No parameter schema in public metadata yet.
hsk_diffCompare two HSK levels to see vocabulary overlap and differences.
Compare two HSK levels to see vocabulary overlap and differences.
No parameter schema in public metadata yet.
Sponsors
Readme
HSK MCP Server
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-9 (new 3.0) + HSK 1-6 (old 2.0)
HSK 3.0 has 9 levels. Levels 1-6 are individual levels; levels 7-9 are grouped as a single advanced band. In this database, levels 7-9 are stored as level 7.
What is this?
MCP is an open protocol that lets AI assistants (like Claude) call external tools and read external data in a standardized way. This server turns the HSK vocabulary into a set of tools that any MCP-compatible client can use.
When you connect this server to Claude (or any MCP client), the AI can look up Chinese words, search by meaning, compare HSK levels, find homophones, suggest study vocabulary, and more — all backed by a real database instead of relying on training data.
Connecting to the server
The MCP endpoint URL is:
https://hsk-mcp.linsnotes.com/mcp
Details
- Repository
- github.com/kuibinlin/hsk-mcp-server
- Website
- github.com/kuibinlin/hsk-mcp-server
- Categories
- Media & Entertainment, Productivity & Office
- Transport
- HTTP