Isparta Uni Obs MCP

🚀 Isparta University OBS MCP Tools

This project contains the MCP (Model Context Protocol) tools for accessing the OBS (Student Information System) of Isparta University. It is used to securely retrieve students' information, announcements, and academic data.

✨ Features

• 🔐 Secure Login System: ASP.NET WebForms-based login
• 📊 Student Information: Personal and academic information
• 📢 Announcement System: Track the latest announcements
• 📚 Course Information: Course list and details
• 📋 Transcript: Grade transcript and academic records
• 🔍 HTML Parsing: Automatic data extraction
• 🛡️ Session Management: Secure session control
• 🚀 Academic Analysis: GPA trend analysis and performance tracking
• 🎯 Course Selection Assistant: Prerequisite checking and recommendations
• 🔔 Notification System: Smart alerts and reminders
• 📤 Data Export: Export in JSON, CSV, PDF, and Excel formats

📦 Features and Status

Status legend: ✅ Ready · 🧪 Experimental · 🕓 Planned · ⚠️ Problematic

🔐 Basic Functions

• ✅ Login/Logout Operations — Secure session management
• ✅ Page Navigation — Access to different OBS pages
• ✅ Debug Modes — Detect technical issues

📊 Academic Information

• ✅ Student Profile Information — Personal information, faculty, department, advisor
• ✅ Academic Transcript — Credit and GPA information by class
• ✅ Semester Courses — Current semester courses, grades, instructors
• ✅ Courses Taken — Detailed list of all your courses

🚀 Newly Added Features

• ✅ Academic Analysis — GPA trend analysis, credit completion rate, course success graph
• ✅ Performance Tracking — Academic goals, progress status, goal recommendations
• ✅ Course Selection Assistant — Prerequisite checking, credit calculation, course conflict checking
• ✅ Notification System — Low grade alerts, absenteeism alerts, tuition payment reminders
• ✅ Data Export — Comprehensive reporting in JSON, CSV, PDF, and Excel formats

📬 Communication and Information

• 🕓 Message Box — Messages from instructors and student affairs
• ✅ Announcements — Latest university announcements
• ✅ System Menu Access — View all available page links

🟡 Program and Schedule

• ✅ Course Schedule — Weekly class hours
• ⚠️ Exam Schedule — Exam dates (technical issues due to dynamic content)
• ✅ Absenteeism Tracking — Attendance information

💰 Financial Information

• ✅ Tuition Information — Payment status
• ✅ Library/Material Information — Debt status

📋 Operations and Applications

• ✅ Registration Renewal — Add/drop courses
• ✅ Thesis Operations — Project applications
• ✅ Internship Applications — Mandatory/optional internships
• ✅ Petition Operations — Online application form

📚 Educational Content

• ✅ Course Documents — Course materials
• ✅ Online Education Platform — Access to distance education
• ✅ Events — Events you've participated in

❌ Current Issues

• ⚠️ Grade Average Calculation — JavaScript-based page
• ⚠️ Exam Schedule — Problem loading dynamic content
• ⚠️ Some Reports — Content display issues

🚀 Installation

Requirements

• Python 3.10+
• pip or uv

Steps

1. Clone the project:

git clone https://github.com/kullanici-adi/isparta-uni-obs-mcp.git
cd isparta-uni-obs-mcp

2. Install dependencies:

# Using pip
pip install -r requirements.txt

# Or using uv
uv sync

3. Start the MCP Server:

python server.py

💻 Usage Examples

🔐 Login Operations

Student Login

# Basic login
result = student_login(
    base_url="https://obs.isparta.edu.tr",
    username="**********",
    password="your_password"
)

# Debug login (detailed information)
debug_info = student_login_debug(
    base_url="https://obs.isparta.edu.tr",
    username="**********", 
    password="your_password"
)

Logout

result = student_logout()

📊 Data Retrieval

Student Information

# Basic information
info = student_info()

# Parsed information
parsed_info = student_info_parsed()

# HTML parsing
html_content = "..."
parsed = parse_student_info(html_content)

Announcements

# Announcement list
announcements = student_announcements(limit=10)

# Announcements from a specific page
announcements = student_announcements(path="/custom/path", limit=5)

Courses and Transcript

# Course list
courses = student_courses()

# Transcript
transcript = student_transcript()

Parsed Student Pages

# Semester courses (DonemDersleri.aspx)
term_courses = student_term_courses()

# My courses (Derslerim.aspx)
my_courses = student_my_courses()

Page Navigation

# Navigate to a specific page
page_info = student_navigate_to_page("/Birimler/Ogrenci/Derslerim.aspx")

🚀 New Features

Academic Analysis

# Comprehensive academic analysis
analytics = student_academic_analytics()

# Performance tracking
performance = student_performance_tracking()

# Course selection assistant
course_advisor = student_course_advisor()

Notification System

# Get all notifications
notifications = student_notifications()

# Notification settings
settings = student_notification_settings()

# Mark a notification as read
result = student_mark_notification_read("notification_id")

Data Export

# Export in JSON format
json_data = student_export_data(format="json", data_type="academic")

# Export in CSV format
csv_data = student_export_data(format="csv", data_type="all")

# List supported formats
formats = student_export_formats()

📚 Documentation

Login Functions

Data Retrieval Functions

Student Page Functions

🚀 Newly Added Features

📋 Sample Outputs

Academic Analysis

{
  "success": true,
  "analytics": {
    "gpa_trend": {
      "current_gpa": 3.45,
      "trend": "improving",
      "improvement_potential": 0.55
    },
    "credit_analysis": {
      "completion_rate": 75.5,
      "remaining_credits": 60,
      "estimated_semesters_to_graduation": 2.0
    },
    "overall_score": {
      "total_score": 82.3,
      "level": "A",
      "grade": "BA"
    }
  }
}

Notification System

{
  "success": true,
  "notifications": [
    {
      "type": "Academic Warning",
      "priority": "High",
      "title": "Low GPA Alert",
      "message": "Your GPA is below 1.85 - 2.0",
      "action_required": true
    }
  ],
  "summary": {
    "total_notifications": 3,
    "high_priority": 1,
    "medium_priority": 2
  }
}

Data Export

{
  "success": true,
  "format": "csv",
  "filename": "student_data_20241201_143022.csv",
  "size_bytes": 15420,
  "download_ready": true
}

🔧 Technical Details

Project Structure

uni-mcp/
├── core.py              # Main functions and new features
├── server.py            # MCP server and tool definitions
├── requirements.txt     # Python dependencies
├── requirements-mcp.txt # MCP dependencies
├── pyproject.toml      # Project configuration
└── README.md           # This file

Adding New Functions

1. Add the function to the core.py file.
2. Add the MCP tool to the server.py file.
3. Update the documentation.
4. Test it.

Debugging

To run in debug mode:

debug_info = student_login_debug(...)
print(json.dumps(debug_info, indent=2))

🛡️ Security

• Passwords are stored securely.
• Session management is automatic.
• HTTPS connections are mandatory.
• CSRF tokens are handled automatically.

📄 License

This project is licensed under the MIT License.

🤝 Contributing

1. Fork the project.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

Project Images

• Academic analysis

📞 Contact

You can open an issue or contact us if you have any questions.

⚠️ Important Note

This tool is for educational purposes only. The user is responsible for its use.