METU Course Info MCP Server

A Model Context Protocol (MCP) server for querying Middle East Technical University (METU / ODTÜ) course details, curriculum requirements, prerequisites, equivalents, and student course categories from the METU Student Portal (SAIS at https://student.metu.edu.tr).

Features

This MCP server integrates with:

1. View Program Course Details (64):

   • Search across 200+ METU departments and academic semesters.

   • List offered courses for any department and semester with credits, ECTS, level, and status.

   • View detailed course sections, instructor assignments, schedules, and critical announcements.

   • Query course prerequisites and required minimum passing grades.

   • Query course replacement / equivalence (Denk Dersler) rules.

   • View thesis work courses for graduate departments.

2. View Student Course Categories (178):

   • View the authenticated student's curriculum program types (e.g. Major / Minor).

   • View course requirements and elective categories (Must Courses, Departmental Electives, Non-Departmental Electives, Free Electives).

   • List specific courses required or permitted under each category for the student.

Note regarding View Course Capacity (158): Program 158 uses image CAPTCHA verification on each lookup, and is omitted per current automated requirements.

Related MCP server: cmucourses-connector

Installation

Using uv:

# Clone or navigate to the repository
cd /path/to/metu-course-info-mcp

# Create virtual environment and install
uv venv
uv pip install -e .

Configuration

Create or update a .env file in the root directory:

SAIS_USERNAME=your_metu_username   # e.g. e123456
SAIS_PASSWORD=your_sais_password   # your METU password
LOCALE=tr                          # tr or en
PORT=8300                          # optional port for SSE transport

Available MCP Tools

Running the Server

Stdio Transport (Default for MCP Clients)

# Run using uv
uv run metu-course-info-mcp

# Or directly with Python
.venv/bin/python -m metu_course_info_mcp

SSE Transport (HTTP Server)

uv run metu-course-info-mcp --transport sse --port 8300

MCP Client Configuration

Claude Desktop / Antigravity / Cursor Configuration

Add this to your MCP configuration file (mcp_config.json or claude_desktop_config.json):

{
  "mcpServers": {
    "metu-course-info": {
      "command": "/Users/ates/Documents/projects/metu-course-info-mcp/.venv/bin/python",
      "args": ["-m", "metu_course_info_mcp"],
      "env": {
        "SAIS_USERNAME": "your_metu_username",
        "SAIS_PASSWORD": "your_sais_password",
        "LOCALE": "tr"
      }
    }
  }
}

Running Tests

uv run pytest -v