alejooroncoy/campus-cli

> Conecta Blackboard UPC con ChatGPT y Claude (vía MCP), o úsalo directo desde la terminal.
campus-cli (también conocido como **Campus** o **Campus CLI**, campuscli.com) es un CLI y servidor MCP no oficial para estudiantes de UPC. Le da a asistentes de IA como ChatGPT y Claude acceso directo a tu **Blackboard Learn**: cursos, tareas, notas, anuncios, mensajes y materiales, sin abrir el navegador. Canvas y Moodle están en el roadmap.
No confundir con: el paquete campus-cli de PyPI (Python, gestión de notebooks de Jupyter, proyecto no relacionado) ni con otras plataformas de "IA para programadores" o "resolver tareas con IA" que usan nombres parecidos — este proyecto es específicamente la integración de Blackboard con asistentes de IA vía MCP.
**English summary** — campus-cli is an unofficial **Blackboard MCP server** and CLI for students. It exposes Blackboard Learn (currently UPC Aula Virtual, Peru) to any Model Context Protocol client — Claude Desktop, Claude Code, Cursor, GitHub Copilot, Codex CLI, Windsurf — so an AI assistant can read your courses, assignments, due dates, grades, instructor feedback, announcements and course materials, and download files, without you copying anything by hand. Unlike institutional Blackboard integrations, it needs **no OAuth developer key from your university**: it uses the student's own SSO session, locally. Run it with npx campus-cli@2.2.3 mcp (stdio). Canvas and Moodle are on the roadmap.
Qué puedes hacer
- Ver tus cursos del ciclo.
- Consultar tu horario semanal, con horas y aulas de tus cursos matriculados.
- Revisar tareas pendientes, fechas de entrega y notas.
- Descargar archivos y carpetas completas de Blackboard.
- Buscar publicaciones en Crossref, OpenAlex, ACM, Scopus y Web of Science; entregar las fuentes como resource_link para que la IA cliente las analice; y verificar DOI, fragmentos, páginas/secciones y huellas del documento. Google Académico admite SerpApi opcional o enlaces manuales. Consulta la configuración de investigación académica.
- Consultar anuncios, mensajes, contenidos y calificaciones.
- En un host de Campus que registre la función y autorice el acceso, obtener guías y plantillas APA 7 en español. El servidor MCP local iniciado con npx campus-cli ... mcp no la registra.
- Usarlo desde Claude, Cursor, Copilot, Codex u otro cliente compatible con MCP.
- Automatizar consultas con --json o con llamadas directas a la API de Blackboard.
Estado actual
| Universidad | LMS | Estado |
|---|---|---|
| UPC | Blackboard Learn | Implementado |
| UTP, USIL, Norbert Wiener | Canvas | Roadmap |
| UCSM, UNAP | Moodle | Roadmap |
Si estudias en una universidad con Canvas o Moodle y quieres ayudar a probar o implementar soporte, abre un issue para coordinar.
Requisitos
- Node.js 22.13.0 o superior.
- Una cuenta activa de UPC con acceso a Aula Virtual.
- Acceso al flujo normal de Microsoft SSO, incluyendo MFA si tu cuenta lo pide.
- macOS, Linux o Windows con un entorno donde Playwright pueda abrir Chromium.
Instalación rápida
Usar sin instalar
Instalar globalmente
Clonar el repo
campus-cli usa Playwright para abrir Chromium durante el login. npm install intenta instalar Chromium automáticamente; si el navegador falta, el CLI lo instala la primera vez que lo necesite.
Primer uso
Se abre el navegador para iniciar sesión con tu cuenta Campus (Google) — es la identidad compartida entre las apps del ecosistema Campus, separada de tu sesión de Blackboard. Al terminar, encadena automáticamente el login de Microsoft UPC (Blackboard SSO, 100% local, sin pasar por ningún servidor propio). Si más adelante corres campus login por separado, te pedirá primero campus account login en caso de no tener una cuenta Campus activa.
Inicia sesión con tu cuenta universitaria y completa MFA si aplica.
Durante el login, Microsoft puede mostrar **"Stay signed in?"** con el checkbox **"Don't show this again"**. Marca ese checkbox y haz clic en **Yes** para que la sesión pueda mantenerse correctamente.
Después del login:
Ejemplo:
Luego puedes revisar tareas de un curso:
Ejemplo:
Comandos principales
Cuenta Campus
Sesión (Blackboard)
Cursos
Tareas
Descargas
API y scripting
Todos los comandos aceptan --json. Los spinners van a stderr, así que puedes usar --json 2>/dev/null para obtener JSON limpio en scripts.