Hosted MCP server · #116 most used on Smithery
hsk-mcp
kuibin-dev/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)
- Uses
- 4.8k
- Tools
- 13
- Runs
- Hosted
- Prompts
- 2
- Listed
- 7mo ago
Get started
Add it to your agent
npx -y @smithery/cli@latest install kuibin-dev/hsk-mcp --client claudeSwap --client claude for cursor, vscode, windsurf or another client. The CLI asks for any required settings.
claude mcp add --transport http hsk https://server.smithery.ai/kuibin-dev/hsk-mcp/mcpA hosted server: nothing to install. Run /mcp in Claude Code to sign in if it asks.
[mcp_servers.hsk]
url = "https://server.smithery.ai/kuibin-dev/hsk-mcp/mcp"Add to ~/.codex/config.toml.
{
"mcpServers": {
"hsk": {
"url": "https://server.smithery.ai/kuibin-dev/hsk-mcp/mcp"
}
}
}Add to ~/.cursor/mcp.json.
{
"servers": {
"hsk": {
"type": "http",
"url": "https://server.smithery.ai/kuibin-dev/hsk-mcp/mcp"
}
}
}Add to .vscode/mcp.json.
gemini mcp add --transport http hsk https://server.smithery.ai/kuibin-dev/hsk-mcp/mcpSaved to .gemini/settings.json.
What it can do
13 tools
hsk_lookup1 paramLook up a Chinese word by simplified characters, traditional characters, or pinyin. Returns all pronunciation forms with meanings, freque…
Look 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.
| Parameter | Type | Description |
|---|---|---|
word | string | Chinese word to look up. Accepts simplified (好), traditional (國), or pinyin (hǎo / hao3 / hao). |
hsk_frequency1 paramGet the frequency ranking and usage statistics for a Chinese word. Returns the word's rank among HSK vocabulary (1 = most frequent), raw …
Get 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.
| Parameter | Type | Description |
|---|---|---|
word | string | Simplified Chinese word. Example: '的', '好', '准备'. |
hsk_convert_script1 paramConvert a Chinese word to all 5 transcription systems: pinyin (tone marks), numeric (tone numbers), Wade-Giles, Bopomofo/Zhuyin, and Gwoy…
Convert 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.
| Parameter | Type | Description |
|---|---|---|
word | string | Simplified Chinese word. Example: '翻译', '好'. |
hsk_classifier1 paramFind the measure word (classifier / 量词) for a Chinese noun. Returns all classifiers associated with the word. Empty list if no classifier…
Find the measure word (classifier / 量词) for a Chinese noun. Returns all classifiers associated with the word. Empty list if no classifiers exist in the dataset.
| Parameter | Type | Description |
|---|---|---|
word | string | Simplified Chinese noun. Example: '书', '航班', '猫'. |
hsk_convert_characters1 paramConvert a Chinese word between simplified and traditional characters. Accepts either script and returns both with pinyin and meanings. Co…
Convert 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.
| Parameter | Type | Description |
|---|---|---|
word | string | Chinese word in simplified or traditional. Example: '国' or '國'. |
hsk_search_meaning2 paramsSearch for HSK words by English meaning using full-text search. Each result includes simplified characters, pinyin, all transcription sys…
Search 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).
| Parameter | Type | Description |
|---|---|---|
query | string | English meaning to search for. Example: 'recommend', 'beautiful', 'to eat'. |
cursor | string | Pagination cursor from a previous response. |
hsk_words_by_radical2 paramsFind all HSK words sharing a given radical (部首). Each word includes simplified/traditional characters, pinyin, part of speech, meanings, …
Find 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).
| Parameter | Type | Description |
|---|---|---|
cursor | string | Pagination cursor from a previous response. |
radical | string | Chinese radical character. Example: '女', '口', '心'. |
hsk_polyphones1 paramList Chinese characters with multiple pronunciations (多音字) in HSK vocabulary. Each result includes all pronunciation forms with pinyin, m…
List 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).
| Parameter | Type | Description |
|---|---|---|
cursor | string | Pagination cursor from a previous response. |
hsk_homophones2 paramsFind HSK words sharing the same pinyin pronunciation (homophones). Useful for drilling tone-pair distinctions. Each result includes simpl…
Find 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).
| Parameter | Type | Description |
|---|---|---|
cursor | string | Pagination cursor from a previous response. |
pinyin | string | Pinyin to search for. Accepts tone marks (yì), tone numbers (yi4), or plain (yi). |
hsk_build_study_set3 paramsBuild a study set of HSK words for a given level, ordered by frequency (most common first). Each word includes simplified/traditional cha…
Build 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).
| Parameter | Type | Description |
|---|---|---|
level | integer | HSK level. Range: 1-7. |
cursor | string | Pagination cursor from a previous response. |
scheme | string | HSK scheme. 'new' = HSK 3.0 (levels 1-7), 'old' = HSK 2.0 (levels 1-6). Default: 'new'. |
hsk_suggest_next4 paramsSuggest the next words to learn at a given HSK level, excluding words already known. Each word includes simplified/traditional characters…
Suggest 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).
| Parameter | Type | Description |
|---|---|---|
known | array | Simplified Chinese words the learner already knows. Example: ['你好', '谢谢', '外卖']. |
level | integer | Target HSK level. Range: 1-7. |
cursor | string | Pagination cursor from a previous response. |
scheme | string | HSK scheme. 'new' = HSK 3.0 (levels 1-7), 'old' = HSK 2.0 (levels 1-6). Default: 'new'. |
hsk_compare1 paramCompare 2-5 Chinese words side by side. Each word shows simplified/traditional characters, pinyin, part of speech, frequency rank, HSK le…
Compare 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.
| Parameter | Type | Description |
|---|---|---|
words | array | Simplified Chinese words to compare. Example: ['聪明', '推荐', '参考']. |
hsk_diff4 paramsCompare two HSK levels to see vocabulary overlap and differences. Shows words exclusive to each level and words shared by both. Useful fo…
Compare 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.
| Parameter | Type | Description |
|---|---|---|
level_a | integer | First HSK level. Range: 1-7. |
level_b | integer | Second HSK level. Range: 1-7. |
scheme_a | string | HSK scheme for level_a. 'new' = HSK 3.0, 'old' = HSK 2.0. Default: 'new'. |
scheme_b | string | HSK scheme for level_b. 'new' = HSK 3.0, 'old' = HSK 2.0. Default: 'new'. |
Ready-made
Prompts
hsk-study-sessionStart a guided HSK study session. Builds a study set for your level, lets you exclude words you already know, and presents vocabulary as a structured table.hsk-word-deep-diveGet comprehensive details about a Chinese word: all transcription systems, frequency rank, part of speech, classifiers, and homophones.
Readable data
Resources
metaServer metadata: dataset version, tool count, and vocabulary statistics.level-1HSK 3.0 level 1 vocabulary list (brief format, ordered by frequency).level-2HSK 3.0 level 2 vocabulary list (brief format, ordered by frequency).level-3HSK 3.0 level 3 vocabulary list (brief format, ordered by frequency).level-4HSK 3.0 level 4 vocabulary list (brief format, ordered by frequency).level-5HSK 3.0 level 5 vocabulary list (brief format, ordered by frequency).level-6HSK 3.0 level 6 vocabulary list (brief format, ordered by frequency).level-7HSK 3.0 level 7 vocabulary list (brief format, ordered by frequency).