Isparta Uni Obs MCP

🚀 伊斯帕爾塔大學OBS MCP工具

本項目包含了用於訪問伊斯帕爾塔大學OBS（學生信息系統）的MCP（模型上下文協議）工具。該工具可用於安全地獲取學生的信息、公告和學術數據。

🚀 快速開始

本項目是針對伊斯帕爾塔大學OBS系統開發的工具，藉助這些工具，你可以安全地獲取學生的各類信息。以下是使用該工具的基本步驟：

1. 克隆項目到本地。
2. 安裝項目所需的依賴。
3. 啟動MCP服務器。

✨ 主要特性

• 🔐 安全登錄系統：基於ASP.NET WebForms的登錄方式。
• 📊 學生信息：包含個人和學術相關信息。
• 📢 公告系統：可跟蹤最新公告。
• 📚 課程信息：提供課程列表及詳細信息。
• 📋 成績單：包含成績明細和學術記錄。
• 🔍 HTML解析：可自動提取數據。
• 🛡️ 會話管理：保障安全的會話控制。
• 🚀 學術分析：支持GPA趨勢分析和學業表現跟蹤。
• 🎯 選課助手：可進行前置課程檢查並提供選課建議。
• 🔔 通知系統：具備智能提醒功能。
• 📤 數據導出：支持將數據導出為JSON、CSV、PDF、Excel等格式。

📦 安裝指南

依賴環境

• Python 3.10及以上版本。
• pip或者uv。

安裝步驟

1. 克隆項目：

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

2. 安裝依賴：

# 使用pip安裝
pip install -r requirements.txt

# 或者使用uv安裝
uv sync

3. 啟動MCP服務器：

python server.py

💻 使用示例

基礎用法

登錄操作

# 學生登錄
result = student_login(
    base_url="https://obs.isparta.edu.tr",
    username="**********",
    password="your_password"
)

# 調試登錄（獲取詳細信息）
debug_info = student_login_debug(
    base_url="https://obs.isparta.edu.tr",
    username="**********", 
    password="your_password"
)

退出登錄

result = student_logout()

獲取學生信息

# 獲取基本信息
info = student_info()

# 獲取解析後的信息
parsed_info = student_info_parsed()

# 解析HTML內容
html_content = "..."
parsed = parse_student_info(html_content)

獲取公告

# 獲取公告列表
announcements = student_announcements(limit=10)

# 從指定頁面獲取公告
announcements = student_announcements(path="/custom/path", limit=5)

獲取課程和成績單

# 獲取課程列表
courses = student_courses()

# 獲取成績單
transcript = student_transcript()

獲取學生頁面信息（解析後）

# 獲取本學期課程信息（DonemDersleri.aspx）
term_courses = student_term_courses()

# 獲取我的課程信息（Derslerim.aspx）
my_courses = student_my_courses()

頁面導航

# 跳轉到指定頁面
page_info = student_navigate_to_page("/Birimler/Ogrenci/Derslerim.aspx")

高級用法

學術分析

# 全面的學術分析
analytics = student_academic_analytics()

# 學業表現跟蹤
performance = student_performance_tracking()

# 選課助手
course_advisor = student_course_advisor()

通知系統

# 獲取所有通知
notifications = student_notifications()

# 獲取通知設置
settings = student_notification_settings()

# 標記通知為已讀
result = student_mark_notification_read("notification_id")

數據導出

# 導出為JSON格式
json_data = student_export_data(format="json", data_type="academic")

# 導出為CSV格式
csv_data = student_export_data(format="csv", data_type="all")

# 列出支持的導出格式
formats = student_export_formats()

📚 詳細文檔

API文檔

登錄函數

數據獲取函數

學生頁面函數

新增特性函數

示例輸出

學術分析

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

通知系統

{
  "success": true,
  "notifications": [
    {
      "type": "Academic Warning",
      "priority": "High",
      "title": "低GPA警告",
      "message": "您的GPA低於1.85至2.0",
      "action_required": true
    }
  ],
  "summary": {
    "total_notifications": 3,
    "high_priority": 1,
    "medium_priority": 2
  }
}

數據導出

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

🔧 技術細節

項目結構

uni-mcp/
├── core.py              # 核心函數和新特性
├── server.py            # MCP服務器和工具定義
├── requirements.txt     # Python依賴
├── requirements-mcp.txt # MCP依賴
├── pyproject.toml      # 項目配置
└── README.md           # 本文件

新增函數

1. 在core.py文件中添加新函數。
2. 在server.py文件中添加對應的MCP工具。
3. 更新文檔。
4. 進行測試。

調試

若要在調試模式下運行，可使用以下代碼：

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

🛡️ 安全說明

• 密碼會被安全存儲。
• 會話管理實現自動化。
• 強制使用HTTPS連接。
• 自動處理CSRF令牌。

📄 許可證

本項目採用MIT許可證。

🤝 貢獻指南

1. Fork本項目。
2. 創建特性分支（git checkout -b feature/amazing-feature）。
3. 提交修改（git commit -m 'Add amazing feature'）。
4. 推送分支（git push origin feature/amazing-feature）。
5. 發起Pull Request。

項目截圖

學術分析

📞 聯繫我們

如有任何疑問，可創建issue或與我們聯繫。

⚠️ 重要提示

本工具僅用於教育目的，使用風險由用戶自行承擔。