🎓 Servidor MCP de Canvas LMS

Un servidor del Protocolo de Contexto de Modelo (MCP) robusto que conecta Claude AI a tu cuenta de Canvas LMS, permitiéndote interactuar con tus cursos mediante lenguaje natural.

Creado con Python · API REST de Canvas · SDK de MCP

✨ Funcionalidades (14 herramientas en 4 módulos)

📚 Tareas y Cursos

Herramienta	Descripción
`canvas_get_course_list`	Listar todos los cursos activos en los que estás inscrito
`canvas_get_assignments`	Obtener todas las tareas (de todos los cursos o filtradas)
`canvas_get_upcoming_deadlines`	Fechas límite en los próximos N días, codificadas por color según urgencia
`canvas_get_assignment_details`	Detalles completos de una tarea específica
`canvas_get_submission_status`	Entregadas vs. pendientes en todos los cursos

📊 Calificaciones

Herramienta	Descripción
`canvas_get_course_grades`	Calificaciones actuales con barras de progreso visuales
`canvas_get_grade_breakdown`	Desglose a nivel de tarea con total acumulado
`canvas_get_missing_assignments`	Todas las tareas no entregadas

📢 Anuncios y Módulos

Herramienta	Descripción
`canvas_get_announcements`	Anuncios recientes en todos los cursos
`canvas_get_course_modules`	Módulos con estado de bloqueado/completado
`canvas_get_module_items`	Elementos en un módulo con casillas de verificación de finalización

📅 Calendario

Herramienta	Descripción
`canvas_get_calendar_events`	Todos los eventos para los próximos N días
`canvas_get_weekly_schedule`	Vista general de la semana
`canvas_get_upcoming_events`	Próximos N eventos en todos los cursos

🚀 Configuración

1. Clonar el repositorio

git clone https://github.com/yourusername/canvas-mcp.git
cd canvas-mcp

2. Instalar dependencias

pip install -r requirements.txt

3. Configurar tus credenciales de Canvas

cp .env.example .env

Edita .env:

CANVAS_BASE_URL=https://yourschool.instructure.com
CANVAS_API_TOKEN=your_token_here

Cómo obtener tu token de API de Canvas:

Inicia sesión en Canvas
Ve a Cuenta → Configuración
Desplázate hasta Integraciones aprobadas
Haz clic en Nuevo token de acceso
Copia el token en tu .env

4. Configurar Claude Desktop

Añade esto a tu claude_desktop_config.json:

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

{
  "mcpServers": {
    "canvas": {
      "command": "python",
      "args": ["/absolute/path/to/canvas-mcp/server.py"],
      "env": {
        "CANVAS_BASE_URL": "canvas_base_url"
        "CANVAS_API_TOKEN": "your_token_here"
      }
    }
  }
}

5. Reiniciar Claude Desktop

¡Las herramientas de Canvas aparecerán ahora en tu barra lateral de Claude!

💬 Ejemplos de prompts

Una vez conectado, intenta preguntarle a Claude:

"¿Qué tareas tengo pendientes para esta semana?"
"¿Cuál es mi promedio estimado actual?"
"¿Me falta entregar alguna tarea?"
"¿Qué anuncios han publicado mis profesores recientemente?"
"Muéstrame el desglose de mis calificaciones para el curso 12345"
"¿Cómo se ve mi semana?"

🗂️ Estructura del proyecto

canvas-mcp/
├── server.py           # MCP server entry point (14 tools)
├── canvas_client.py    # Canvas REST API wrapper with pagination
├── tools/
│   ├── assignments.py  # Assignment & course tools
│   ├── grades.py       # Grade tools
│   ├── announcements.py# Announcement & module tools
│   └── calendar.py     # Calendar tools
├── .env.example        # Environment config template
├── requirements.txt
└── README.md

🔒 Privacidad y Seguridad

Solo lectura — este servidor nunca escribe, envía ni modifica tus datos de Canvas

🛠️ Stack tecnológico

Python 3.10+
MCP SDK — Protocolo de Contexto de Modelo
httpx — Cliente HTTP preparado para asincronía
python-dotenv — Configuración de entorno
API REST de Canvas LMS

Canvas LMS MCP Server