Servidor Canvas MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Canvas. Este servidor permite gestionar cursos, tareas, inscripciones y calificaciones en Canvas.

Prerrequisitos

• Node.js : versión 18 o superior

• Token de API de Canvas : obténgalo de su cuenta de Canvas

• Dominio de Canvas : Normalmente canvas.instructure.com

Configuración

1. Clonar el repositorio

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

2. Instalar dependencias

   npm install

3. Configurar variables de entorno

Copie el archivo de entorno de ejemplo:

Edite .env y reemplace los valores de marcador de posición con su token y dominio de API de Canvas reales.

Construir el proyecto

4. Ejecutar el servidor

   npm start

   El servidor se iniciará y escuchará las solicitudes MCP a través de stdio.

Conexión a Claude Desktop

1. Actualizar la configuración de Claude

   Agregue la configuración del servidor MCP a su claude_desktop_config.json:

Reiniciar Claude Desktop

Cierre Claude Desktop por completo. Vuelva a iniciarlo. Vaya al menú 🔌 para buscar y conectar su servidor Canvas MCP.

Herramientas disponibles (próximamente habrá más material enfocado en los estudiantes)

• canvas_create_course : Crea un nuevo curso en Canvas.

• canvas_update_course : Actualizar un curso existente en Canvas.

• canvas_create_assignment : crea una nueva tarea en un curso de Canvas.

• canvas_update_assignment : Actualizar una tarea existente.

• canvas_submit_grade : Enviar una calificación para la tarea de un estudiante.

• canvas_enroll_user : Inscribe a un usuario en un curso.

Manejo de errores

Las herramientas devuelven mensajes de error con isError: true para indicar problemas. Asegúrese de que todas las variables de entorno necesarias estén configuradas para evitar errores de ejecución.

Solución de problemas

• Errores de compilación:

Verificar la versión de TypeScript: npx tsc --version Limpiar y reconstruir: rm -rf build/ && npm run build

• Errores de tiempo de ejecución:

  Revise los registros para ver los mensajes de error detallados. Asegúrese de que las variables de entorno estén configuradas correctamente.

• Errores de tipo:

  Validar tipos usando la verificación de tipos de TypeScript: npx tsc --noEmit

Contribuyendo

¡Agradecemos sus contribuciones! Abra un problema o envíe una solicitud de incorporación de cambios para cualquier mejora o corrección de errores.

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Notas adicionales

• Seguridad de tipos : el archivo types.ts garantiza que todas las interacciones con la API de Canvas sean seguras en cuanto a tipos, lo que reduce los errores de tiempo de ejecución y mejora la capacidad de mantenimiento del código.

• Manejo de errores : el servidor maneja los errores con elegancia al devolver mensajes significativos con el indicador isError , lo que permite que el cliente (por ejemplo, Claude Desktop) comprenda y reaccione adecuadamente.

• Variables de entorno : la información confidencial, como los tokens API, se gestiona a través de variables de entorno, lo que mejora la seguridad y la flexibilidad en diferentes entornos.

• Modularidad : separar las preocupaciones en diferentes archivos ( types.ts , client.ts , index.ts ) hace que la base de código sea más fácil de navegar y mantener.

Siéntete libre de ajustar las rutas de archivo y la configuración según las necesidades específicas de tu proyecto. ¡Avísame si necesitas más ayuda!