🎓 Isparta Üniversitesi OBS MCP Tools

Bu proje, Isparta Üniversitesi'nin OBS (Öğrenci Bilgi Sistemi) sistemine erişim sağlayan MCP (Model Context Protocol) tools'larını içerir. Öğrencilerin bilgilerini, duyurularını ve akademik verilerini güvenli bir şekilde çekmek için kullanılır.

✨ Özellikler

• 🔐 Güvenli Login Sistemi: ASP.NET WebForms tabanlı login

• 📊 Öğrenci Bilgileri: Kişisel ve akademik bilgiler

• 📢 Duyuru Sistemi: Güncel duyuruları takip etme

• 📚 Ders Bilgileri: Ders listesi ve detayları

• 📋 Transkript: Not dökümü ve akademik kayıtlar

• 🔍 HTML Parsing: Otomatik veri çıkarma

• 🛡️ Session Yönetimi: Güvenli oturum kontrolü

• 🚀 Akademik Analiz: GPA trend analizi ve performans takibi

• 🎯 Ders Seçim Asistanı: Ön koşul kontrolü ve öneriler

• 🔔 Bildirim Sistemi: Akıllı uyarılar ve hatırlatıcılar

• 📤 Veri Export: JSON, CSV, PDF, Excel formatlarında export

📦 Özellikler ve Durum

Durum efsanesi: ✅ Hazır · 🧪 Deneysel · 🕓 Planlı · ⚠️ Sorunlu

🔐 Temel Fonksiyonlar

• ✅ Giriş/Çıkış İşlemleri — Güvenli oturum yönetimi

• ✅ Sayfa Navigasyonu — Farklı OBS sayfalarına erişim

• ✅ Debug Modları — Teknik sorunları tespit etme

📊 Akademik Bilgiler

• ✅ Öğrenci Profil Bilgileri — Kişisel bilgiler, fakülte, bölüm, danışman

• ✅ Akademik Transkript — Sınıf bazında kredi ve GPA bilgileri

• ✅ Dönem Dersleri — Mevcut dönem dersleri, notlar, öğretim görevlileri

• ✅ Aldığınız Dersler — Tüm derslerinizin detaylı listesi

🚀 Yeni Eklenen Özellikler

• ✅ Akademik Analiz — GPA trend analizi, kredi tamamlama oranı, ders başarı grafiği

• ✅ Performans Takibi — Akademik hedefler, ilerleme durumu, hedef önerileri

• ✅ Ders Seçim Asistanı — Ön koşul kontrolü, kredi hesaplama, ders çakışma kontrolü

• ✅ Bildirim Sistemi — Düşük not uyarıları, devamsızlık uyarıları, harç ödeme hatırlatıcıları

• ✅ Veri Export — JSON, CSV, PDF, Excel formatlarında kapsamlı raporlama

📬 İletişim ve Bilgilendirme

• 🕓 Mesaj Kutusu — Öğretim görevlileri ve öğrenci işleri mesajları

• ✅ Duyurular — Güncel üniversite duyuruları

• ✅ Sistem Menü Erişimi — Tüm mevcut sayfa linklerini görme

🟡 Program ve Takvim

• ✅ Ders Programı — Haftalık ders saatleri

• ⚠️ Sınav Programı — Sınav tarihleri (dinamik içerik kaynaklı teknik sorunlar)

• ✅ Devamsızlık Takibi — Yoklama bilgileri

💰 Mali Bilgiler

• ✅ Harç Bilgileri — Ödeme durumları

• ✅ Kütüphane/Malzeme Bilgileri — Borç durumu

📋 İşlemler ve Başvurular

• ✅ Kayıt Yenileme — Ders ekleme/bırakma

• ✅ Bitirme Tezi İşlemleri — Proje başvuruları

• ✅ Staj Başvuruları — Zorunlu/isteğe bağlı staj

• ✅ Dilekçe İşlemleri — Online başvuru formu

📚 Eğitim İçerikleri

• ✅ Ders Dökümanları — Ders materyalleri

• ✅ Online Eğitim Platformu — Uzaktan eğitim erişimi

• ✅ Etkinlikler — Katıldığınız etkinlikler

❌ Şu Anda Sorun Yaşananlar

• ⚠️ Not Ortalaması Hesaplama — JavaScript tabanlı sayfa

• ⚠️ Sınav Programı — Dinamik içerik yükleme sorunu

• ⚠️ Bazı raporlar — İçerik görüntüleme sorunları

🚀 Kurulum

Gereksinimler

• Python 3.10+

• pip veya uv

Adımlar

1. Projeyi klonlayın:

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

2. Bağımlılıkları yükleyin:

# pip ile
pip install -r requirements.txt

# veya uv ile
uv sync

3. MCP Server'ı başlatın:

python server.py

📖 Kullanım

🔐 Login İşlemleri

Öğrenci Girişi

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

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

Çıkış

result = student_logout()

📊 Veri Çekme

Öğrenci Bilgileri

# Temel bilgiler
info = student_info()

# Parse edilmiş bilgiler
parsed_info = student_info_parsed()

# HTML parse etme
html_content = "..."
parsed = parse_student_info(html_content)

Duyurular

# Duyuru listesi
announcements = student_announcements(limit=10)

# Belirli sayfadan duyurular
announcements = student_announcements(path="/custom/path", limit=5)

Dersler ve Transkript

# Ders listesi
courses = student_courses()

# Transkript
transcript = student_transcript()

Öğrenci Sayfaları (Parse edilmiş)

# Dönem dersleri (DonemDersleri.aspx)
term_courses = student_term_courses()

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

Sayfa Navigasyonu

# Belirli sayfaya git
page_info = student_navigate_to_page("/Birimler/Ogrenci/Derslerim.aspx")

🚀 Yeni Özellikler

Akademik Analiz

# Kapsamlı akademik analiz
analytics = student_academic_analytics()

# Performans takibi
performance = student_performance_tracking()

# Ders seçim asistanı
course_advisor = student_course_advisor()

Bildirim Sistemi

# Tüm bildirimleri al
notifications = student_notifications()

# Bildirim ayarları
settings = student_notification_settings()

# Bildirimi okundu işaretle
result = student_mark_notification_read("notification_id")

Veri Export

# JSON formatında export
json_data = student_export_data(format="json", data_type="academic")

# CSV formatında export
csv_data = student_export_data(format="csv", data_type="all")

# Desteklenen formatları listele
formats = student_export_formats()

🛠️ API Referansı

Login Fonksiyonları

Veri Çekme Fonksiyonları

Öğrenci Sayfa Fonksiyonları

🚀 Yeni Eklenen Özellikler

📋 Örnek Çıktılar

Akademik Analiz

{
  "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"
    }
  }
}

Bildirim Sistemi

{
  "success": true,
  "notifications": [
    {
      "type": "Academic Warning",
      "priority": "High",
      "title": "Düşük GPA Uyarısı",
      "message": "GPA'nız 1.85 ile 2.0'ın altında",
      "action_required": true
    }
  ],
  "summary": {
    "total_notifications": 3,
    "high_priority": 1,
    "medium_priority": 2
  }
}

Veri Export

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

🔧 Geliştirme

Proje Yapısı

uni-mcp/
├── core.py              # Ana fonksiyonlar ve yeni özellikler
├── server.py            # MCP server ve tool tanımları
├── requirements.txt     # Python bağımlılıkları
├── requirements-mcp.txt # MCP bağımlılıkları
├── pyproject.toml      # Proje konfigürasyonu
└── README.md           # Bu dosya

Yeni Fonksiyon Ekleme

1. core.py dosyasına fonksiyonu ekleyin

2. server.py dosyasına MCP tool'u ekleyin

3. Dokümantasyonu güncelleyin

4. Test edin

Hata Ayıklama

Debug modunda çalıştırmak için:

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

🛡️ Güvenlik

• Şifreler güvenli şekilde saklanır

• Session yönetimi otomatiktir

• HTTPS bağlantıları zorunludur

• CSRF token'ları otomatik işlenir

📝 Lisans

Bu proje MIT lisansı altında lisanslanmıştır.

🤝 Katkıda Bulunma

1. Fork yapın

2. Feature branch oluşturun (git checkout -b feature/amazing-feature)

3. Commit yapın (git commit -m 'Add amazing feature')

4. Push yapın (git push origin feature/amazing-feature)

5. Pull Request açın

Proje Görselleri

• Akademik analiz

📞 İletişim

Sorularınız için issue açabilir veya iletişime geçebilirsiniz.

Not: Bu araç sadece eğitim amaçlıdır. Kullanım sorumluluğu kullanıcıya aittir.