University Rankings

You can run this FastMCP-based server to explore university disciplines, their evaluation levels, and rankings. It provides multi-dimensional queries like searching universities or disciplines, filtering by grade, regional browsing, and various rankings to help you understand the landscape of higher education subject evaluations.

How to use

You interact with the MCP server through an MCP client. Start the local server, then send queries such as finding all disciplines for a university, listing universities that offer a discipline, filtering by grade, or viewing top universities by the number of disciplines. You can also inspect discipline rankings and identify strong disciplines by university or region. Commands are issued in natural language prompts, and the server returns structured results that you can use directly in your workflow.

How to install

Prerequisites you need before running the server:

pip install -r requirements.txt

# Ensure you have Python 3.11+ installed
python --version

Additional sections

Configuration and running details are provided below to help you set up and run the server locally and to connect with clients.

Environment and data file configuration are required to load the data used for queries. You will point the server to the data file containing the fourth round discipline evaluation results.

{
  "mcpServers": {
    "university_rankings": {
      "type": "stdio",
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {
        "UNIVERSITY_EXCEL_PATH": "/path/to/第四轮学科评估结果.xlsx"
      }
    },
    "university_rankings_http": {
      "type": "http",
      "url": "http://localhost:9000/sse",
      "args": []
    }
  },
  "envVars": [
    {
      "name": "UNIVERSITY_EXCEL_PATH",
      "description": "Path to the Excel data file containing the evaluation results",
      "required": true,
      "example": "/path/to/第四轮学科评估结果.xlsx"
    }
  ]
}

Available tools

search_university

Search for a university by name to view all its disciplines and evaluation levels, with grouped statistics by grade.

search_discipline

Query a discipline to see which universities offer it and their rankings, with grade distribution.

filter_by_grade

Filter disciplines by evaluation grade(s) to get matching discipline points and grade distribution.

browse_by_province

Browse regional distribution of disciplines across universities within a selected province.

university_ranking

Rank universities by metrics like total disciplines, number of A+ disciplines, and number of top-tier universities.

discipline_ranking

Rank disciplines by number of universities offering them and by A+ presence.

strong_disciplines

Identify strong disciplines for a given university or province, focusing on A and A+ grades.

grade_analysis

Analyze the distribution of disciplines across grades and highlight popular disciplines.

get_statistics

Obtain statistical summaries grouped by province, discipline level, or university category.