hsk-mcp

A remote Model Context Protocol (MCP) server that gives AI assistants structured access to the complete HSK Chinese vocabulary dataset.

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Hsk Lookup: 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
  • Hsk Frequency: 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.
  • Hsk Convert Script: 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

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

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)

Как подключить

Как подключить hsk-mcp к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://hsk-mcp--kuibin-dev.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить hsk-mcp к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://hsk-mcp--kuibin-dev.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить hsk-mcp к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://hsk-mcp--kuibin-dev.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (13)

Технические названия из tools/list. Нужны только разработчикам.

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.