Servidor Canvas MCP

Este repositorio contiene una implementación de servidor del Protocolo de Control de Mensajes (MCP) para interactuar con la API del Sistema de Gestión de Aprendizaje Canvas. El servidor está diseñado para funcionar con Claude Desktop y, potencialmente, con otros clientes MCP.

Descripción general

El servidor Canvas MCP proporciona una interfaz local para la API de Canvas LMS, lo que le permite:

• Listar y administrar cursos
• Acceder a tareas y entregas
• Ver anuncios
• Recuperar programas de estudio y módulos del curso
• Administrar usuarios e inscripciones
• Generar resúmenes de cursos

Prerrequisitos

• Python 3.x
• Entorno virtual (venv)
• Token de API de Canvas
• URL de la API de Canvas (p. ej., https://canvas.illinois.edu/api/v1 )

Instalación

1. Clonar este repositorio:

2. Crear y activar un entorno virtual:

3. Instalar dependencias:

Configuración

1. Crear archivo de entorno

Cree un archivo .env en el directorio raíz con las siguientes variables:

Reemplace los valores con:

• Tu token de API de Canvas ( Cómo obtener tu token de API de Canvas )
• URL de la API de Canvas de tu universidad

2. Configurar el script de inicio

El script start_canvas_server.sh ya está configurado para:

• Cargar variables de entorno desde el archivo .env
• Activar el entorno virtual
• Ejecute la implementación del servidor en caché

Hacer que el script de inicio sea ejecutable:

3. Configuración del escritorio de Claude

1. Instale Claude Desktop si aún no lo ha hecho.
2. Cree o edite el archivo de configuración de Claude Desktop:

3. Agregue la configuración del servidor Canvas MCP:

Reemplace /Users/YOUR_USERNAME/path/to/canvas-mcp con la ruta absoluta a donde clonó este repositorio.

4. Reinicie Claude Desktop para cargar la nueva configuración.

Herramientas disponibles

El servidor proporciona las siguientes herramientas para la interacción con Canvas LMS:

Gestión de cursos

• list_courses : enumera todos los cursos para el usuario autenticado
• get_course_details : Obtenga información detallada sobre un curso específico
• summarize_course : Generar un resumen completo de un curso

Tareas

• list_assignments : enumera todas las tareas de un curso
• get_assignment_details : Obtenga información detallada sobre una tarea específica
• get_assignment_description : Obtener la descripción completa de una tarea

Envíos

• list_submissions : enumera todos los envíos para una tarea específica

Usuarios

• list_users : Lista todos los usuarios inscritos en un curso

Recursos

• list_announcements : Lista todos los anuncios de un curso
• get_course_syllabus : Obtener el programa de estudios de un curso
• get_course_modules : Obtener todos los módulos de un curso

Uso con Claude Desktop

Este servidor MCP está diseñado para funcionar sin problemas con Claude Desktop:

1. Claude Desktop iniciará automáticamente el servidor cuando sea necesario
2. Verás las herramientas de la API de Canvas en la interfaz de Claude Desktop (ícono de martillo 🔨)
3. Puedes pedirle a Claude que realice operaciones en Canvas como "Muéstrame mis cursos" u "Obtener el programa de estudios de mi curso de Biología".

Para realizar pruebas manuales, puede iniciar el servidor directamente:

Detalles técnicos

Implementación del servidor

El servidor utiliza:

• fastmcp : una biblioteca de Python para crear servidores MCP
• httpx : para solicitudes HTTP asincrónicas a la API de Canvas
• Mecanismos de almacenamiento en caché para mejorar el rendimiento en las búsquedas de cursos

El archivo de implementación principal es canvas_server_cached.py , que proporciona:

• Almacenamiento en caché eficiente de la información del curso
• Manejo de paginación para solicitudes de API de Canvas
• Manejo y reporte de errores
• Compatibilidad con identificadores y códigos de cursos

Dependencias

El servidor requiere los siguientes paquetes de Python:

• httpx : Para solicitudes HTTP
• fastmcp : Para la implementación del servidor MCP
• requests : Para algunas operaciones HTTP
• Otras bibliotecas estándar para codificación y redes

Solución de problemas

Si encuentra problemas:

1. El servidor no se inicia
   • Verifique que su archivo .env exista y contenga credenciales válidas
   • Verifique la ruta del entorno virtual en start_canvas_server.sh
   • Asegúrese de que todas las dependencias estén instaladas
2. Errores de autenticación
   • Verifique que su token de API de Canvas sea válido y no esté vencido
   • Comprueba que tienes los permisos necesarios en Canvas
3. Problemas de conexión
   • Asegúrese de que la URL de su API de Canvas sea correcta
   • Comprueba tu conexión a Internet
   • Verifique que su institución no haya restringido el acceso a la API
4. Depuración
   • Verifique los registros del servidor en la consola de Claude Desktop
   • Intente ejecutar el servidor manualmente para ver el resultado del error

Consideraciones de seguridad

• Su token de API de Canvas le otorga acceso a su cuenta de Canvas
• Nunca envíe su archivo .env al control de versiones
• Considere usar un token con permisos limitados si es posible
• El servidor se ejecuta localmente en su máquina y no expone sus credenciales externamente.

Contribuyendo

¡Agradecemos sus contribuciones! Siéntase libre de:

• Enviar problemas sobre errores o solicitudes de funciones
• Crear solicitudes de extracción con mejoras
• Comparta sus casos de uso y comentarios

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Creado por Vishal Sachdev