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或与我们联系。

⚠️ 重要提示

本工具仅用于教育目的，使用风险由用户自行承担。