Learning Hour MCP

Genera contenido de Learning Hour y tableros Miro para Coaches Técnicos.

Documentación

learning-hour-mcp

Genera contenido para Learning Hours dirigido a Technical Coaches usando IA. Crea sesiones de práctica estructuradas que ayuden a los equipos de desarrollo a dominar la excelencia técnica mediante el Modelo de Aprendizaje 4C.

¿Qué es esto?

Un servidor MCP que ayuda a los Technical Coaches a dirigir Learning Hours: sesiones de práctica estructuradas de 60 minutos donde los equipos mejoran sus habilidades de codificación mediante la práctica deliberada. Genera planes de sesión, ejemplos de código e incluso puede crear tableros interactivos en Miro.

¿Para quién es?

Technical Coaches que facilitan sesiones de aprendizaje en equipo
Team Leads que quieren mejorar las prácticas técnicas de su equipo
Desarrolladores que organizan coding dojos o sesiones de práctica

Instalación

Requisitos previos

Claude Desktop - Instala la aplicación de escritorio
Anthropic API Key - Regístrate y crea una clave ($5 de crédito gratis para cuentas nuevas)

Configuración completa

Elige tu editor preferido:

Claude Desktop

Añade a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "learning-hour": {
      "command": "npx",
      "args": ["-y", "learning-hour-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-key",
        "MIRO_ACCESS_TOKEN": "your-miro-token-optional",
        "GITHUB_TOKEN": "your-github-token-optional"
      }
    }
  }
}

Pasos de configuración:

Abre la configuración de Claude Desktop (cmd/ctrl + ,)
Ve a "Developer" → "Edit Config"
Pega la configuración anterior
Reemplaza your-anthropic-key con tu clave real
Guarda y reinicia Claude Desktop

VSCode

Añade a tu settings.json de VSCode:

{
  "mcp.servers": {
    "learning-hour": {
      "command": "npx",
      "args": ["-y", "learning-hour-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-key",
        "MIRO_ACCESS_TOKEN": "your-miro-token-optional",
        "GITHUB_TOKEN": "your-github-token-optional"
      }
    }
  }
}

Pasos de configuración:

Instala la Extensión MCP para VSCode
Abre settings.json (Cmd/Ctrl+Shift+P → "Preferences: Open Settings (JSON)")
Añade la configuración anterior
Reemplaza los tokens con tus valores reales
Recarga la ventana de VSCode (Cmd/Ctrl+Shift+P → "Developer: Reload Window")

Cursor

Añade a tu configuración de Cursor:

{
  "mcpServers": {
    "learning-hour": {
      "command": "npx",
      "args": ["-y", "learning-hour-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-key",
        "MIRO_ACCESS_TOKEN": "your-miro-token-optional",
        "GITHUB_TOKEN": "your-github-token-optional"
      }
    }
  }
}

Pasos de configuración:

Abre la configuración de Cursor (Cmd/Ctrl + ,)
Haz clic en "Features" → "Claude" → "Advanced"
Añade la configuración del servidor MCP
Reemplaza los tokens con tus valores reales
Reinicia Cursor

Requisito: Solo ANTHROPIC_API_KEY es obligatorio. Los otros tokens habilitan funciones adicionales.

Inicio rápido

Después de la instalación, prueba esto en Claude:

"Usa las herramientas de learning hour para crear una sesión sobre la refactorización Extract Method"

Claude generará un plan completo de sesión de 60 minutos con:

Actividad de conexión inicial
Introducción del concepto
Ejercicio práctico de codificación
Reflexión y compromiso

Herramientas disponibles

`generate_session`

Genera un plan completo de sesión de Learning Hour con actividades que siguen el modelo 4C (Connect, Concept, Concrete, Conclusion).

{
  "topic": "Feature Envy"
}

`generate_code_example`

Crea ejemplos de código antes/después para un tema específico.

{
  "topic": "Extract Method",
  "language": "typescript"
}

`create_miro_board`

Crea un nuevo tablero de Miro o añade marcos a un tablero existente (requiere MIRO_ACCESS_TOKEN).

{
  "sessionContent": { /* from generate_session */ },
  "existingBoardId": "optional-board-id"  // If provided, adds frames to existing board
}

`list_miro_boards`

Lista todos los tableros de Miro accesibles con tu token (requiere MIRO_ACCESS_TOKEN).

{
  "limit": 50,  // Optional, max 50
  "cursor": "optional-pagination-cursor"
}

`get_miro_board`

Obtén detalles sobre un tablero específico de Miro (requiere MIRO_ACCESS_TOKEN).

{
  "boardId": "board-id-to-get"
}

`delete_miro_board`

Elimina un tablero de Miro (requiere MIRO_ACCESS_TOKEN). ¡Úsalo con precaución!

{
  "boardId": "board-id-to-delete",
  "confirm": true  // Required safety check
}

`analyze_repository`

Encuentra ejemplos de código reales en repositorios de GitHub (requiere GITHUB_TOKEN).

`analyze_tech_stack`

Analiza el stack tecnológico de un repositorio para crear contenido específico para el equipo (requiere GITHUB_TOKEN).

Funciones opcionales

Habilitar la creación de tableros en Miro

Convierte tu Learning Hour en un tablero de taller visual e interactivo

Obtén un token de Miro:

Ve a Miro Apps
Crea una nueva aplicación (nómbrala "Learning Hours")
Copia el token de acceso
Añádelo como MIRO_ACCESS_TOKEN en tu configuración

Habilitar el análisis de repositorios

Encuentra ejemplos de código reales del código base de tu equipo

Crea un GitHub Personal Access Token:

Nombre: "Learning Hour MCP"
Expiración: 90 días (recomendado)
Permisos: repo (acceso de lectura)
Añádelo como GITHUB_TOKEN en tu configuración

Aprende más

Diamante Technical Coaching - Refactor to Grow Newsletter
SammanCoaching.org - Recursos de technical coaching y guías de Learning Hours
Learning Hours - Catálogo de temas para Learning Hours
4C Learning Model - Connect, Concept, Concrete, Conclusion
Technical Coaching - Rol y prácticas

Solución de problemas

Error "Tool not found": Asegúrate de haber reiniciado Claude Desktop después de añadir la configuración.

"Invalid API key": Verifica que copiaste la clave completa, incluidos los prefijos (sk-ant-...).

El tablero de Miro no se crea: Comprueba que tu MIRO_ACCESS_TOKEN sea válido y tenga permisos para crear tableros.

Contribuciones

Consulta CONTRIBUTING.md para la configuración de desarrollo y las pautas.

Licencia

MIT