kuibinlin avatar

hsk-mcp

kuibinlin/hsk-mcp-server

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 tools

Public 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

View the full README on GitHub

Details

Repository
github.com/kuibinlin/hsk-mcp-server
Website
github.com/kuibinlin/hsk-mcp-server
Categories
Media & Entertainment, Productivity & Office
Transport
HTTP

Related Media & Entertainment MCP servers

View all
1makkov-design avatarFrame Lensmakkov-design/framelensEyes and ears for AI agents: measured cuts, easing, palette, beats and transcripts from any video.1stars
2mcp-dir avatarNotebookLMmcp-dir/notebooklm-mcpGoogle NotebookLM via natural language: create notebooks, add sources (PDF, URL, YouTube) and ask gr1stars
3ndjordjevic avatarPinRAGndjordjevic/pinragMCP RAG: index PDFs, repos, YouTube, Discord, text; optional YouTube vision; query with citations.1stars
4saranshbamania avatarMobile Device Mcpsaranshbamania/mobile-device-mcpAI control of Android/iOS devices. Screenshots, UI tree, AI vision, Flutter, video. 49 tools.1stars
5animeapi-ai avatarAnimeAPIanimeapi-ai/animeapi-mcpAnime image and video generation from $0.003 per image. Pay as you go, no subscription.0stars
6cosmonote avatarCosmonotecosmonote/pocketbaseAccess your Cosmonote audio notes, transcriptions, summaries, and action items.0stars