s21-canvas-mcp

Servidor Model Context Protocol (MCP) para integrar asistentes de inteligencia artificial (Claude Desktop, Cursor, Antigravity, Windsurf, VS Code Copilot, Codex CLI) con la plataforma Canvas LMS de la Universidad Siglo 21.

Proporciona capacidades para consultar asignaturas, calificaciones, trabajos prácticos, cronogramas y realizar la extracción en memoria del contenido de lecturas y documentos PDF para análisis, síntesis y asistencia académica mediante modelos de lenguaje.

Instalación

Seleccione la configuración correspondiente a su entorno o cliente de IA. Es necesario contar con un token de acceso personal de Canvas LMS (consulte las instrucciones en Obtención del Token de Canvas).

1. Claude Desktop

Ruta del archivo de configuración:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "siglo21": {
      "command": "npx",
      "args": ["-y", "s21-canvas-mcp"],
      "env": {
        "CANVAS_TOKEN": "tu_token_de_canvas_aqui",
        "CANVAS_URL": "https://siglo21.instructure.com"
      }
    }
  }
}

2. Antigravity (Gemini)

Archivo: .gemini/settings.json en el workspace (o configuración global en ~/.gemini/settings.json)

{
  "mcpServers": {
    "siglo21": {
      "command": "npx",
      "args": ["-y", "s21-canvas-mcp"],
      "env": {
        "CANVAS_TOKEN": "tu_token_de_canvas_aqui",
        "CANVAS_URL": "https://siglo21.instructure.com"
      }
    }
  }
}

3. Cursor

Archivo: .cursor/mcp.json en el workspace

{
  "mcpServers": {
    "siglo21": {
      "command": "npx",
      "args": ["-y", "s21-canvas-mcp"],
      "env": {
        "CANVAS_TOKEN": "tu_token_de_canvas_aqui",
        "CANVAS_URL": "https://siglo21.instructure.com"
      }
    }
  }
}

4. VS Code Copilot

Archivo: .vscode/settings.json en el workspace

Nota: Visual Studio Code emplea una clave específica (mcp.servers en lugar de mcpServers).

{
  "mcp": {
    "servers": {
      "siglo21": {
        "command": "npx",
        "args": ["-y", "s21-canvas-mcp"],
        "env": {
          "CANVAS_TOKEN": "tu_token_de_canvas_aqui",
          "CANVAS_URL": "https://siglo21.instructure.com"
        }
      }
    }
  }
}

5. Windsurf

Archivo: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "siglo21": {
      "command": "npx",
      "args": ["-y", "s21-canvas-mcp"],
      "env": {
        "CANVAS_TOKEN": "tu_token_de_canvas_aqui",
        "CANVAS_URL": "https://siglo21.instructure.com"
      }
    }
  }
}

6. Codex CLI (OpenAI)

Archivo: ~/.codex/config.json

{
  "mcpServers": {
    "siglo21": {
      "command": "npx",
      "args": ["-y", "s21-canvas-mcp"],
      "env": {
        "CANVAS_TOKEN": "tu_token_de_canvas_aqui",
        "CANVAS_URL": "https://siglo21.instructure.com"
      }
    }
  }
}

Obtencion del Token de Canvas

Inicie sesión en Canvas Siglo 21.
Diríjase a Cuenta.
Desplácese hasta la sección Tokens de acceso aprobados y seleccione + Nuevo token de acceso.
Asigne un nombre identificador (por ejemplo, MCP-Agent) y seleccione Generar token.
Copie el token generado y asígnelo al parámetro CANVAS_TOKEN en la configuración correspondiente.

IMPORTANTE: No darle los permisos del token a nadie, ya que permite el acceso a toda tu información académica. En caso de hacerlo revocarlo desde la misma sección.

Herramientas Disponibles

Herramienta	Descripción	Parámetros
`s21_open_exam_simulator`	Simulador interactivo de exámenes con persistencia en SQLite local, temporizador de API, modos examen/práctica y panel institucional Siglo 21.	`port` (número, opcional), `auto_open` (booleano)
`s21_save_questions_to_bank`	Registra preguntas en la base de datos local SQLite para la generación de simulacros por materia y módulo.	`course_id`, `course_name`, `questions` (array)
`s21_get_exam_bank_summary`	Estadísticas del banco de preguntas y registro histórico de exámenes en SQLite.	-
`s21_open_interactive_guide`	Portal web interactivo con documentación de herramientas, casos de uso y generador de prompts.	`port` (número, opcional), `auto_open` (booleano)
`s21_check_academic_status`	Análisis de calificaciones mínimas requeridas para Promoción Directa (7+) o Regularidad (5+).	`course_id` (número), `target_promo_grade`, `target_regular_grade`
`s21_generate_practice_quiz`	Generación estructurada de preguntas tipo examen con fundamentación conceptual.	`course_id`, `module_number`, `reading_number`, `question_count`
`s21_audit_rubric`	Auditoría de borradores de entregas académicas frente a la rúbrica oficial de evaluación.	`course_id`, `assignment_id`, `draft_text`
`s21_get_pending_tasks`	Consolidación de tareas pendientes y entregas con fechas límite.	-
`s21_get_reading`	Consulta y extracción de texto de lecturas SAM (1.1 a 4.4).	`course_id`, `module_number`, `reading_number`
`s21_read_pdf_content`	Extracción de contenido de documentos PDF en memoria sin almacenamiento en disco.	`file_id` o `download_url`, `max_pages`
`s21_search_readings`	Búsqueda transversal por términos en material y lecturas descargadas.	`query` (string)
`s21_list_courses`	Consulta de asignaturas activas o concluidas, calificaciones y períodos académicos.	`include_concluded` (booleano), `search` (string)
`s21_get_assignments`	Trabajos prácticos, consignas en formato Markdown y criterios de rúbrica.	`course_id` (número)
`s21_get_modules`	Estructura de módulos SAM, lecturas y actividades organizadas por unidad.	`course_id` (número)
`s21_get_course_files`	Explorador de archivos y documentos asociados a la asignatura.	`course_id` (número)
`s21_get_discussion_topics`	Foros de discusión académica y consignas de trabajo grupal.	`course_id` (número)
`s21_get_syllabus`	Programa oficial de la asignatura y datos del cuerpo docente.	`course_id` (número)
`s21_get_upcoming_events`	Próximos eventos y fechas límite del calendario institucional.	-
`s21_get_announcements`	Anuncios institucionales y publicaciones de cátedra.	`course_ids` (array de números)
`s21_get_my_profile`	Datos del perfil de estudiante (nombre, identificador institucional, correo electrónico).	-

Desarrollo Local

Para compilar y ejecutar el proyecto en un entorno de desarrollo local:

cd s21-canvas-mcp
npm install
npm run build

Ejecución directa del servidor compilado:

node dist/index.js

Para registrar el binario en el entorno local:

npm link

Configuración MCP para el binario enlazado:

{
  "mcpServers": {
    "siglo21": {
      "command": "s21-canvas-mcp",
      "env": {
        "CANVAS_TOKEN": "...",
        "CANVAS_URL": "https://siglo21.instructure.com"
      }
    }
  }
}

Compatibilidad de Clientes MCP

Cliente	Transporte	Estado	Observaciones
Claude Desktop	stdio	Compatible	Soporte completo
Antigravity (Gemini)	stdio	Compatible	Soporte completo
Cursor	stdio	Compatible	Soporte completo
VS Code Copilot	stdio	Compatible	Requiere clave `mcp.servers` en configuración
Windsurf	stdio	Compatible	Soporte completo
Codex CLI (OpenAI)	stdio	Compatible	Soporte completo
Codex Cloud (ChatGPT)	—	No compatible	Entorno aislado sin soporte de transporte MCP
ChatGPT (Web / Desktop App)	HTTP remoto	Limitado	Requiere despliegue como servicio HTTP accesible públicamente

s21-canvas-mcp

s21-canvas-mcp

Instalación

1. Claude Desktop

2. Antigravity (Gemini)

3. Cursor

4. VS Code Copilot

5. Windsurf

6. Codex CLI (OpenAI)

Obtencion del Token de Canvas

Herramientas Disponibles

Desarrollo Local

Compatibilidad de Clientes MCP

Latest Blog Posts

MCP directory API