Gaokao Ranking Query

Servidor de Consulta de Ranking do Gaokao (MCP)

Este é um serviço baseado em MCP (Meta Control Protocol) usado para consultar a posição no ranking de uma pontuação do Gaokao na província correspondente.

Funcionalidades

Este serviço oferece as seguintes duas ferramentas:

1. get_rank - Consultar ranking do Gaokao

Com base na província do candidato, ano do exame, categoria do exame e pontuação específica, consulta a posição no ranking dessa pontuação dentro da província.

Parâmetros:

• province (str): Nome da província, por exemplo, "北京", "上海", "河南".
• year (str): Identificador do ano do exame, por exemplo, "2024", "2023". Também pode ser uma combinação de ano e nível de escolaridade, por exemplo, "2024本科".
• category (str): Categoria do exame, por exemplo, "理科", "文科", "物理类", "历史类", "3+3综合".
• score (int): Pontuação total do Gaokao, geralmente variando entre 0 e 750.

Valor de retorno:

• (int): A posição no ranking dessa pontuação dentro da província sob as condições especificadas. Quanto menor o número, maior o ranking.

Cenários de uso:

• Referência importante no preenchimento de preferências de vestibular.
• Previsão e análise de linhas de corte históricas.
• Estatísticas e pesquisas na área de educação.

Observações:

• Certifique-se de que a província, o ano e a categoria inseridos estejam dentro do intervalo suportado pelo serviço (os dados vêm de data/gaokao.db).
• A pontuação inserida deve estar dentro de um intervalo válido e razoável (0-750).
• O resultado do ranking é baseado em dados históricos e serve apenas como referência.

2. get_categories - Obter lista de categorias de exame

Com base na província e no ano especificados, consulta a lista de todas as categorias de exame disponíveis para essa combinação.

Parâmetros:

• province (str): Nome da província, por exemplo, "北京", "上海", "广东".
• year (str): Identificador do ano do exame, por exemplo, "2024", "2023". Também pode ser uma combinação de ano e nível de escolaridade.

Valor de retorno:

• (list[str]): Uma lista contendo os nomes de todas as categorias de exame disponíveis, ordenada em ordem alfabética.

Cenários de uso:

• Antes de consultar o ranking, entender quais categorias de exame estão disponíveis para uma província e ano específicos.
• Fornecer opções dinâmicas de categorias de exame para a interface do usuário.
• Validar se a categoria de exame inserida pelo usuário é válida.

Observações:

• Certifique-se de que a província e o ano inseridos estejam dentro do intervalo suportado pelo serviço.

Como usar

Adicione as seguintes informações de configuração no config.json do Cliente MCP:

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