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瀏覽器（不支持其他瀏覽器，如果你能添加支持，請自行實現）。
• 你的登錄信息僅在本地使用，不會傳輸到其他地方。
• 圖像驗證碼需要手動解決，瀏覽器會保持打開狀態以便你操作。