nuces-flex-mcp

🚀 FAST-NUCES flex学生门户MCP服务器

这是一个MCP服务器，它能将像Claude Desktop或GitHub Copilot这样的AI助手直接连接到你的Flex学生门户。你可以用通俗易懂的英语询问有关你的学术数据的问题。

🚀 快速开始

本MCP服务器可将AI助手与Flex学生门户相连，让你能以自然的英语交流方式获取学术数据相关信息。

✨ 主要特性

连接成功后，你可以进行自然对话： | 询问内容 | 获取结果 | |-------------|-------------| | "评价我的成绩单" | AI对成绩单进行一针见血的诚实评价 | | "我PF这门课及格了吗？" | 快速计算你当前的课程情况 | | "我旷了多少节课？" | 进行出勤情况的实际核查 | | "将我的成绩与班级平均分作比较" | 了解你在班级中的排名情况 |

📦 安装指南

1. 克隆仓库并安装依赖：

git clone <repo-url>
cd FLEX
pip install -r requirements.txt

2. 创建包含你登录信息的 .env 文件：

FLEX_ROLL_NO=22F-XXXX
FLEX_PASSWORD=your_password

3. 配置你的MCP客户端：

{
  "mcpServers": {
    "flex": {
      "command": "python",
      "args": ["C:/path/to/FLEX/server.py"],
      "env": {
        "FLEX_ROLL_NO": "22F-XXXX",
        "FLEX_PASSWORD": "your_password"
      }
    }
  }
}

{
  "flex": {
    "command": "python",
    "args": ["C:/path/to/FLEX/server.py"]
  }
}

💻 使用示例

基础用法

1. 启动你的MCP客户端（Claude Desktop / Copilot）。
2. 首次使用时，说 "Login to FLEX" ，Chrome浏览器会打开以进行验证码验证。
3. 如果出现图像验证码，需手动解决（你有2分钟时间）。
4. 登录成功后，就可以开始提问啦！

📚 详细文档

可用工具

| 工具 | 描述 | |------|-------------| | login | 打开Chrome浏览器进行验证码认证登录 | | get_attendance | 获取所有课程的出勤情况 | | get_marks | 获取带有班级统计信息的详细成绩 | | get_transcript | 获取包含GPA的完整学术成绩单 | | get_mca | 获取用于相对评分的修正班级平均分 | | get_courses | 获取当前学期注册的课程 | | get_fee_report | 获取缴费历史和费用详情 | | check_login_status | 验证会话是否处于活跃状态 |

项目结构

FLEX/
├── server.py           # MCP入口点
├── auth.py             # 登录和会话管理
├── tools/              # MCP工具实现
│   ├── login.py
│   ├── attendance.py
│   ├── marks.py
│   ├── transcript.py
│   ├── mca.py
│   ├── courses.py
│   ├── fees.py
│   └── status.py
└── parsers/            # HTML解析逻辑
    ├── attendance.py
    ├── marks.py
    ├── transcript.py
    ├── courses.py
    ├── fees.py
    └── challan.py

🔧 技术细节

注意事项

• 登录会话在你重启MCP服务器之前会一直保持。
• 必须安装Chrome浏览器（不支持其他浏览器，如果你能添加支持，请自行实现）。
• 你的登录信息仅在本地使用，不会传输到其他地方。
• 图像验证码需要手动解决，浏览器会保持打开状态以便你操作。