Nuces Flex MCP

🚀 FAST-NUCES flex Student Portal MCP Server

このMCPサーバーは、Claude DesktopやGitHub CopilotなどのAIアシスタントを直接Flex Student Portalに接続します。日常の英語で学術データに関する質問をすることができます。

🚀 クイックスタート

接続後は、自然にチャットするだけです。

✨ 主な機能

必要条件

• Python 3.11以上
• Google Chromeのインストール（ログイン自動化用）
• Claude DesktopまたはGitHub Copilot（MCPサポート付き）

📦 インストール

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クライアントを設定します。
   Claude Desktop

   `%APPDATA%\Claude\claude_desktop_config.json`を編集します。 ```json { "mcpServers": { "flex": { "command": "python", "args": ["C:/path/to/FLEX/server.py"], "env": { "FLEX_ROLL_NO": "22F-XXXX", "FLEX_PASSWORD": "your_password" } } } } ```
   GitHub Copilot

   MCP設定に以下を追加します。 ```json { "flex": { "command": "python", "args": ["C:/path/to/FLEX/server.py"] } } ```

💻 使用例

1. MCPクライアント（Claude Desktop / Copilot）を起動します。
2. 初回起動時に**"Login to FLEX"** と言うと、ChromeがCAPTCHA入力用に開きます。
3. 画像CAPTCHAが表示された場合は、手動で解いてください（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をインストールする必要があります（他のブラウザはサポートされていません。もしサポートを追加できる場合は、ぜひ行ってください）。
• 認証情報はローカルでのみ使用され、他に送信されることはありません。
• 画像CAPTCHAは手動で解く必要があり、ブラウザは開いたままになります。