这是一个基于 MCP (Meta Control Protocol) 的服务,用于查询高考分数在对应省份的排名位次。
本服务提供以下两个工具:
根据考生所在的省份、考试年份、考试类别以及具体分数,查询该分数在省内的排名位次。
参数:
province
(str): 省份名称,例如 "北京", "上海", "河南"。year
(str): 考试年份标识,例如 "2024", "2023"。也可以是年份和学历层次的组合,例如 "2024本科"。category
(str): 考试类别,例如 "理科", "文科", "物理类", "历史类", "3+3综合"。score
(int): 高考总分数,范围通常在 0-750 之间。
返回值:
- (int): 该分数在指定条件下的省内排名位次。数字越小,排名越高。
使用场景:
- 高考志愿填报时的重要参考。
- 对历年分数线进行预测和分析。
- 教育领域的数据统计与研究。
注意事项:
- 请确保输入的省份、年份、类别在服务支持的范围内(数据来源于
data/gaokao.db
)。 - 输入的分数必须在合理的有效范围内 (0-750)。
- 排名结果基于历史数据,仅供参考。
根据指定的省份和年份,查询该组合下所有可用的考试类别列表。
参数:
province
(str): 省份名称,例如 "北京", "上海", "广东"。year
(str): 考试年份标识,例如 "2024", "2023"。也可以是年份和学历层次的组合。
返回值:
- (list[str]): 一个包含所有可用考试类别名称的列表,按字母顺序排序。
使用场景:
- 在查询排名前,了解特定省份和年份有哪些考试类别可供选择。
- 为用户界面提供动态的考试类别选项。
- 验证用户输入的考试类别是否有效。
注意事项:
- 请确保输入的省份、年份在服务支持的范围内。
在MCP Client的config.json中添加如下配置信息:
{
"mcpServers": {
"mcp-gaokao-rank": {
"command": "uvx",
"args": [
"mcp-gaokao-rank"
]
}
}
}