Nuces Flex MCP

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

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

🚀 快速开始

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

✨ 主要特性

连接成功后，你可以进行自然对话：

📦 安装指南

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. 登录成功后，就可以开始提问啦！

📚 详细文档

可用工具

项目结构

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浏览器（不支持其他浏览器，如果你能添加支持，请自行实现）。
• 你的登录信息仅在本地使用，不会传输到其他地方。
• 图像验证码需要手动解决，浏览器会保持打开状态以便你操作。