The HSK course books (标准教程 HSK 4 上/下, Vietnamese edition) as structured data, read-only: lessons with texts, pinyin, words with Vietnamese, grammar, exercises with answers, workbook listening with audio links.
https://hsk-mcp.phucbm.com/mcp
Settings → Connectors → Add custom connector → paste the URL above.
Claude Code: claude mcp add --transport http hsk https://hsk-mcp.phucbm.com/mcp
| Name | Title | Description | Access | Example |
|---|---|---|---|---|
about | About this server | What HSK is, its sources, the levels and lessons served so far, and how to study with it. Start here. | public | What is the HSK connector? |
list_lessons | Lessons | The lessons of a level, one entry each: number, book (上/下), title (zh, pinyin, Vietnamese), pages, its texts (title, audio code) and grammar points, whether the workbook lesson is there, and reviewed (true once the owner checked the extraction). Lessons not extracted yet are listed by number in notExtracted. | public | Which lessons and grammar points does HSK 4 have? |
get_lesson | One lesson | One textbook lesson: warmup (热身), texts (课文: lines with speaker, hanzi and pinyin, the audio link, the new words and names beside each), words (生词: hanzi, pinyin, part of speech, Vietnamese, text), grammar (注释: explanation in Chinese and Vietnamese, examples, exercises, 比一比 comparisons), questions on the texts, exercises (扩展, 运用) and culture (文化), each with its page. part picks one block (default all). Never any answer: get them from exercises with answers: true when marking. | public | Show me the texts of HSK 4 lesson 1. |
grammar | Grammar points | Without point: every grammar point of the level (or of one lesson), one line each: lesson, number, heading, page, its 比一比 comparison. With point (the heading, e.g. 即使……也…… or 刚, or part of it): each matching point in full: explanation in Chinese and Vietnamese, examples, exercises without answers (marking: exercises with answers: true and the exercise id), and the comparison (same, different, table). | public | Explain 即使……也…… from HSK 4. |
vocab | Vocabulary | Words with pinyin, part of speech and Vietnamese, and the lesson they're taught in. With lesson: that lesson's 生词 in book order, with the text each comes from and the page, plus its proper names; a lesson not extracted yet answers from the word list (词语总表, no text numbers). Without lesson: the level's whole word list. star = beyond the HSK list (printed with *). | public | Give me the words of HSK 4 lesson 1, text 3. |
exercises | Exercises | A lesson's exercises in book order: textbook (热身, grammar 练一练 and 做一做, questions on the texts, 扩展, 运用) and workbook (listening, reading, writing), each with id, section, type (fill, choice, order, match, judge, open), page, instruction, word bank, items. By default the questions only (no answers, no listening transcripts): ask the learner first. With answers: true, only the answers (per exercise id and item n), to mark after they answered; answer_by key = the book's key, claude = a model answer (accept any correct answer), open items have none. | public | Quiz me on the exercises of HSK 4 lesson 1. |
listening | Listening test | A lesson's workbook listening (听力): per part, the audio link (one track per part, e.g. 01-1), the instruction and the items: question and options. By default no transcripts and no answers: play the audio, let the learner answer. With answers: true, only the transcript and the answer of each item (and of each shared passage), to mark. | public | Give me the listening test of HSK 4 lesson 1. |
audio | Audio link | The link to one audio track (mp3) and what it is: textbook code LL-T = lesson LL, text T (printed beside each 课文, e.g. 01-3); workbook code LL-P = lesson LL, listening part P (e.g. 01-1). available says whether the file is on the server yet. | public | Play the audio of HSK 4 lesson 1, text 3. |
search | Search the books | Where a word, phrase, sentence or grammar point appears: hanzi (exact substring), pinyin with or without tones (xingfu, xìngfú) or Vietnamese with or without diacritics. Hits, ranked word entries → names → grammar points → text lines → grammar examples → exercise questions → reading passages → culture, each with lesson, where, page and the line. Never searches answers or listening transcripts. total is the number of hits before limit. | public | Where does 浪漫 appear in HSK 4? |
HSK v0.1.0 · Contact: the owner (unlisted connector)