🎓 Canvas Student MCP Server

Un servidor Model Context Protocol (MCP) completo y optimizado para permitir a asistentes de Inteligencia Artificial (Claude Desktop, Cursor, Gemini, ChatGPT, Cline, etc.) interactuar fluidamente con la plataforma educativa Canvas LMS (Canvas Student) de Instructure en nombre de un estudiante.

🌟 Características Principales

• 28 herramientas especializadas cubriendo el ciclo académico completo del estudiante.

• Optimizado para Asistentes IA:

  • Paginación automática (per_page=50/100) para no omitir materias ni tareas.

  • Limpieza de HTML crudo a Markdown legible para ahorrar tokens y mejorar la comprensión del LLM.

  • Formateo de fechas ISO 8601 a horarios legibles.

  • Manejo amigable de permisos y restricciones institucionales.

• Arquitectura Asíncrona: Basado en FastMCP 4.x y HTTPX.

Related MCP server: Canvas Assignment Assistant

📋 Catálogo de Herramientas MCP

1. Perfil y Conexión

2. Cursos y Calificaciones

3. Tareas y Exámenes (Assignments & Quizzes)

4. Entregas y Retroalimentación

5. Agenda, To-Do y Entregas Faltantes

6. Anuncios y Foros

7. Módulos, Páginas y Archivos

8. Bandeja de Mensajería (Inbox)

🔑 Cómo Obtener tu Token de Canvas LMS

1. Abre Canvas LMS en tu navegador (la URL de tu colegio o universidad).

2. En la barra lateral izquierda, haz clic en Cuenta (Account) -> Configuración (Settings).

3. Desplázate hacia abajo hasta la sección Tokens de acceso aprobados (Approved Integrations).

4. Haz clic en el botón + Nuevo token de acceso (+ New Access Token).

5. En "Propósito", escribe un nombre descriptivo (ej: Asistente IA MCP) y opcionalmente define una fecha de expiración.

6. Haz clic en Generar token.

7. Copia el token inmediatamente, ya que Canvas solo lo muestra una vez.

⚙️ Configuración e Instalación

1. Clonar o ingresar a la carpeta del proyecto

cd "d:\Proyectos\Visual Studio Projects\Canva Student MCP"

2. Instalar dependencias

pip install -r requirements.txt

3. Configurar variables de entorno

Copia .env.example a .env:

cp .env.example .env

Edita .env con tus datos:

CANVAS_BASE_URL=https://tu-universidad.instructure.com
CANVAS_API_TOKEN=tu_token_generado_aqui

☁️ Despliegue en la Nube (MCPHosting, Render, Railway, Docker)

El proyecto está 100% adaptado para desplegarse como servicio remoto en plataformas especializadas de MCP o contenedores en la nube:

Despliegue en MCPHosting (mcphosting.io)

1. Inicia sesión en MCPHosting con tu cuenta de GitHub.

2. Haz clic en New Project y selecciona tu repositorio DA0806/canvas-student-mcp.

3. Configura las variables de entorno del proyecto en el dashboard de MCPHosting:

   • CANVAS_BASE_URL: URL de tu institución educativa (ej: https://canvas.instructure.com).

   • CANVAS_API_TOKEN: Tu token generado en Canvas.

   • MCP_TRANSPORT: http (por defecto).

4. Despliega el proyecto. MCPHosting compilará el contenedor utilizando el Dockerfile o requirements.txt y validará el endpoint de salud /health.

5. Copia la URL pública generada (ej. https://tu-slug.mcphosting.io/mcp) para conectarlo con Claude, ChatGPT o Cursor de forma remota.

Despliegue con Docker

# Construir la imagen
docker build -t canvas-student-mcp .

# Correr el contenedor
docker run -p 8000:8000 \
  -e CANVAS_BASE_URL="https://tu-universidad.instructure.com" \
  -e CANVAS_API_TOKEN="tu_token" \
  canvas-student-mcp

🤖 Integración con Clientes MCP

Configuración en Claude Desktop

Añade lo siguiente a tu archivo claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json en Windows):

{
  "mcpServers": {
    "canvas-student": {
      "command": "python",
      "args": [
        "d:\\Proyectos\\Visual Studio Projects\\Canva Student MCP\\main.py"
      ],
      "env": {
        "CANVAS_BASE_URL": "https://tu-universidad.instructure.com",
        "CANVAS_API_TOKEN": "tu_token_aqui"
      }
    }
  }
}

Configuración en Cursor / Gemini / Cline / Roo Code

Configura un nuevo servidor MCP tipo stdio:

• Nombre: Canvas Student

• Comando: python

• Argumentos: d:/Proyectos/Visual Studio Projects/Canva Student MCP/main.py

• Variables de Entorno:

  • CANVAS_BASE_URL: URL de tu institución.

  • CANVAS_API_TOKEN: Tu token de Canvas.

💬 Ejemplos de Preguntas para tu Asistente IA

Una vez conectado, podrás pedirle cosas como:

• "¿Qué tareas tengo pendientes de entregar para esta semana en todos mis cursos?"

• "Revisa si tengo entregas atrasadas o faltantes en Canvas."

• "¿Cuál es mi promedio y calificación actual en cada asignatura?"

• "Léeme las instrucciones y la rúbrica de la Tarea 3 del curso de Algoritmos."

• "¿Qué avisos nuevos han publicado mis profesores en los últimos 7 días?"

• "Busca diapositivas o PDFs subidos en la materia de Física."

• "Entrega este enlace de Google Drive en la tarea de Proyecto Final."