get_rankLABSCO SUMMARY
Rank, not score, because that is what admissions compare.
Raw scores are not comparable across years, because the paper and the cohort both change; provincial rank roughly is, which is why it is the number people use when choosing where to apply. Checking the available categories first is not optional busywork: provincial tracks differ enough that a wrong category name gets you nothing.
What it is
A small Python server over historical gaokao data. It answers the question that matters when filling in university preferences: not what your score is, but what position that score puts you in within your province for that year and exam track.
What you get
get_rankreturns the provincial rank for a score —province,year,categoryandscore, with score in the 0-750 range and a lower rank meaning higher placementget_categoriesreturns the exam categories available for a given province and year, sorted alphabetically — worth calling first, since the valid categories differ by provinceyearaccepts a plain year or a year-and-level combination;categorycovers the various provincial tracks
Requirements
Configure your client to run uvx with the argument mcp-gaokao-rank (package mcp-gaokao-rank, version 0.2). No account and no key. Data comes from a bundled database, so coverage is limited to the provinces, years and categories that database contains — and the ranks are historical, which is what makes them useful as a reference rather than a prediction.
Setup effort
One command — uvx mcp-gaokao-rank
USE CASES
01
Working out where a score actually places you
Give the province, year, category and score and read the rank back.
02
Finding out which exam tracks a province used
List the categories for that province and year before querying.
03
Comparing this year against previous ones
Look up the equivalent rank in earlier years rather than comparing raw scores.
2 tools
Listed in project docs. Your client may show a different list.
get_categoriesBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
uvx on PATH
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"mcp-gaokao-rank": {
"command": "uvx",
"args": [
"mcp-gaokao-rank"
]
}
}
}uvx
TERMINAL
uvx mcp-gaokao-rank
