Nuces Flex MCP

🚀 FAST-NUCES flex Student Portal MCP Server

An MCP server that directly connects AI assistants such as Claude Desktop or GitHub Copilot to your Flex Student Portal. You can inquire about your academic data in plain English.

🚀 Quick Start

This MCP server enables seamless connection between AI assistants and your Flex Student Portal. After establishing the connection, you can effortlessly interact with your academic data using natural language.

✨ Features

Once connected, you can engage in natural conversations with the AI assistant:

📦 Installation

Prerequisites

• Python 3.11+
• Google Chrome installed (for login automation)
• Claude Desktop or GitHub Copilot (with MCP support)

Steps

1. Clone the repository and install dependencies:

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

2. Create a .env file with your credentials:

   FLEX_ROLL_NO=22F-XXXX
   FLEX_PASSWORD=your_password
   

3. Configure your MCP client:

   Claude Desktop

   Edit %APPDATA%\Claude\claude_desktop_config.json:

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

   GitHub Copilot

   Add to your MCP settings:

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

💻 Usage Examples

Basic Usage

1. Start your MCP client (Claude Desktop / Copilot).
2. For the first - time use, say "Login to FLEX" , and Chrome will open for CAPTCHA.
3. If an image CAPTCHA appears, solve it manually (you have 2 minutes).
4. Once logged in, you can start asking questions!

📚 Documentation

Available Tools

Project Structure

FLEX/
├── server.py           # MCP entry point
├── auth.py             # Login & session management
├── tools/              # MCP tool implementations
│   ├── login.py
│   ├── attendance.py
│   ├── marks.py
│   ├── transcript.py
│   ├── mca.py
│   ├── courses.py
│   ├── fees.py
│   └── status.py
└── parsers/            # HTML parsing logic
    ├── attendance.py
    ├── marks.py
    ├── transcript.py
    ├── courses.py
    ├── fees.py
    └── challan.py

Notes

⚠️ Important Note

• The login session persists until you restart the MCP server.
• Google Chrome must be installed (Other browsers are not supported. If you can add support, please do so).
• Your credentials are only used locally and are never transmitted elsewhere.
• Image CAPTCHAs require manual solving, and the browser will remain open for you.