منصوبے کے بارے میں

campus-cli ایک غیر سرکاری کمانڈ لائن ٹول اور MCP سرور ہے جو پیرو میں UPC کے ان طلبہ کے لیے ہے جو Blackboard Learn (Aula Virtual) استعمال کرتے ہیں۔ یہ براؤزر کھولے بغیر کورسز، ٹائم ٹیبل، زیر التواء اسائنمنٹس، جمع کرانے کی تاریخیں، گریڈز، اعلانات، پیغامات اور مواد دیکھنے کی سہولت دیتا ہے، اور یہ معلومات Model Context Protocol کے مطابق AI اسسٹنٹس کو فراہم کرتا ہے۔ اہم صلاحیتیں: - سمسٹر کے کورسز کی فہرست بنانا، مواد، فولڈرز، اعلانات، پیغامات اور گریڈز دیکھنا۔ - زیر التواء اسائنمنٹس، کوششوں کی تاریخ، استاد کی رائے اور ہفتہ وار ٹائم ٹیبل (Banner UPC) دیکھنا۔ - Blackboard سے فائلیں اور مکمل فولڈرز ڈاؤن لوڈ کرنا، سائز کی حدود کے ساتھ اور فائلوں کو اوور رائٹ کیے بغیر۔ - فائلیں اپ لوڈ کرنا، ڈرافٹ محفوظ کرنا اور اسائنمنٹس جمع کرانا، MCP کلائنٹ کی واضح تصدیق کے ساتھ۔ - Crossref، OpenAlex، IEEE Xplore، ACM، Scopus، Web of Science اور ScienceDirect میں تعلیمی مضامین تلاش کرنا، DOI کی تصدیق اور واپسی کے نوٹس چیک کرنا۔ - موجودہ SSO سیشن کے ذریعے UPC Class کی ریکارڈنگز اور ٹرانسکرپٹس تک رسائی۔ - Blackboard کے عوامی API پر براہ راست کالز اور اسکرپٹنگ کے لیے JSON آؤٹ پٹ۔ استعمال کے طریقے: براہ راست CLI، stdio کے ذریعے MCP سرور (npx campus-cli mcp) اور raw API۔ یہ MCP سرور کنفیگریشن کے ذریعے Claude Desktop، Claude Code، Cursor، GitHub Copilot، OpenAI Codex CLI اور Windsurf کے ساتھ مربوط ہوتا ہے۔ تصدیق اور رازداری: یہ Playwright استعمال کرتا ہے تاکہ Chromium کھول کر Microsoft SSO مکمل کرے؛ کوکیز مقامی طور پر ~/.blackboard-cli/session.json میں محفوظ ہوتی ہیں۔ یونیورسٹی کی OAuth کلید یا درمیانی سرور کی ضرورت نہیں۔ PostHog کے ساتھ اختیاری تجزیات خصوصیات کی وائٹ لسٹ استعمال کرتے ہیں اور POSTHOG_DISABLED=1 سے غیر فعال کیے جا سکتے ہیں۔ تقاضے: Node.js 22.13.0 یا اس سے اوپر، فعال UPC اکاؤنٹ اور ایسا ماحول جہاں Playwright Chromium کھول سکے۔ اسٹیک: TypeScript، Playwright، Axios، Commander.js، MCP SDK۔ لائسنس ISC۔ Canvas اور Moodle روڈ میپ پر ہیں۔