MCP 高考排名查询服务器

这是一个基于 MCP (Meta Control Protocol) 的服务，用于查询高考分数在对应省份的排名位次。

功能

本服务提供以下两个工具：

1. get_rank - 查询高考排名

根据考生所在的省份、考试年份、考试类别以及具体分数，查询该分数在省内的排名位次。

参数:

• province (str): 省份名称，例如 "北京", "上海", "河南"。
• year (str): 考试年份标识，例如 "2024", "2023"。也可以是年份和学历层次的组合，例如 "2024本科"。
• category (str): 考试类别，例如 "理科", "文科", "物理类", "历史类", "3+3综合"。
• score (int): 高考总分数，范围通常在 0-750 之间。

返回值:

• (int): 该分数在指定条件下的省内排名位次。数字越小，排名越高。

使用场景:

• 高考志愿填报时的重要参考。
• 对历年分数线进行预测和分析。
• 教育领域的数据统计与研究。

注意事项:

• 请确保输入的省份、年份、类别在服务支持的范围内（数据来源于 data/gaokao.db）。
• 输入的分数必须在合理的有效范围内 (0-750)。
• 排名结果基于历史数据，仅供参考。

2. get_categories - 获取考试类别列表

根据指定的省份和年份，查询该组合下所有可用的考试类别列表。

参数:

• province (str): 省份名称，例如 "北京", "上海", "广东"。
• year (str): 考试年份标识，例如 "2024", "2023"。也可以是年份和学历层次的组合。

返回值:

• (list[str]): 一个包含所有可用考试类别名称的列表，按字母顺序排序。

使用场景:

• 在查询排名前，了解特定省份和年份有哪些考试类别可供选择。
• 为用户界面提供动态的考试类别选项。
• 验证用户输入的考试类别是否有效。

注意事项:

• 请确保输入的省份、年份在服务支持的范围内。

使用方法

在MCP Client的config.json中添加如下配置信息：

{
  "mcpServers": {
    "mcp-gaokao-rank": {
      "command": "uvx",
      "args": [
        "mcp-gaokao-rank"
      ]
    }
  }
}