Learning Hour MCP

Gera conteúdo de Learning Hour e quadros Miro para Technical Coaches.

Documentação

learning-hour-mcp

Gere conteúdo de Learning Hour para Technical Coaches usando IA. Crie sessões de prática estruturadas que ajudam equipes de desenvolvimento a dominar a excelência técnica por meio do Modelo de Aprendizagem 4C.

O que é isso?

Um servidor MCP que ajuda Technical Coaches a conduzir Learning Hours - sessões de prática estruturadas de 60 minutos onde equipes melhoram suas habilidades de codificação por meio de prática deliberada. Ele gera planos de sessão, exemplos de código e pode até criar quadros interativos no Miro.

Para quem é isso?

Technical Coaches facilitando sessões de aprendizado em equipe
Team Leads que desejam melhorar as práticas técnicas de suas equipes
Desenvolvedores organizando coding dojos ou sessões de prática

Instalação

Pré-requisitos

Claude Desktop - Instale o aplicativo desktop
Anthropic API Key - Cadastre-se e crie uma chave ($5 de crédito gratuito para novas contas)

Configuração Completa

Escolha seu editor preferido:

Claude Desktop

Adicione à sua configuração do 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"
      }
    }
  }
}

Passos de configuração:

Abra as configurações do Claude Desktop (cmd/ctrl + ,)
Vá para "Developer" → "Edit Config"
Cole a configuração acima
Substitua your-anthropic-key pela sua chave real
Salve e reinicie o Claude Desktop

VSCode

Adicione ao seu settings.json do 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"
      }
    }
  }
}

Passos de configuração:

Instale a Extensão MCP VSCode
Abra o settings.json (Cmd/Ctrl+Shift+P → "Preferences: Open Settings (JSON)")
Adicione a configuração acima
Substitua os tokens pelos seus valores reais
Recarregue a janela do VSCode (Cmd/Ctrl+Shift+P → "Developer: Reload Window")

Cursor

Adicione à sua configuração do 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"
      }
    }
  }
}

Passos de configuração:

Abra as configurações do Cursor (Cmd/Ctrl + ,)
Clique em "Features" → "Claude" → "Advanced"
Adicione a configuração do servidor MCP
Substitua os tokens pelos seus valores reais
Reinicie o Cursor

Obrigatório: Apenas ANTHROPIC_API_KEY é obrigatório. Os outros tokens habilitam recursos adicionais.

Início Rápido

Após a instalação, tente isto no Claude:

"Use as ferramentas de learning hour para criar uma sessão sobre o refatoramento Extract Method"

O Claude gerará um plano completo de sessão de 60 minutos com:

Atividade de conexão inicial
Introdução ao conceito
Exercício prático de codificação
Reflexão e compromisso

Ferramentas Disponíveis

`generate_session`

Gere um plano completo de sessão de Learning Hour com atividades seguindo o modelo 4C (Connect, Concept, Concrete, Conclusion).

{
  "topic": "Feature Envy"
}

`generate_code_example`

Crie exemplos de código antes/depois para um tópico específico.

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

`create_miro_board`

Crie um novo quadro no Miro ou adicione frames a um quadro existente (requer MIRO_ACCESS_TOKEN).

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

`list_miro_boards`

Liste todos os quadros Miro acessíveis com seu token (requer MIRO_ACCESS_TOKEN).

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

`get_miro_board`

Obtenha detalhes sobre um quadro Miro específico (requer MIRO_ACCESS_TOKEN).

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

`delete_miro_board`

Exclua um quadro Miro (requer MIRO_ACCESS_TOKEN). Use com cautela!

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

`analyze_repository`

Encontre exemplos de código reais em repositórios GitHub (requer GITHUB_TOKEN).

`analyze_tech_stack`

Analise a stack de tecnologia de um repositório para criar conteúdo específico para a equipe (requer GITHUB_TOKEN).

Recursos Opcionais

Habilitar Criação de Quadros Miro

Transforme seu Learning Hour em um quadro de workshop visual e interativo

Obtenha um token Miro:

Acesse Miro Apps
Crie um novo aplicativo (nomeie-o "Learning Hours")
Copie o token de acesso
Adicione como MIRO_ACCESS_TOKEN na sua configuração

Habilitar Análise de Repositório

Encontre exemplos de código reais do codebase da sua equipe

Crie um GitHub Personal Access Token:

Nome: "Learning Hour MCP"
Expiração: 90 dias (recomendado)
Permissões: repo (acesso de leitura)
Adicione como GITHUB_TOKEN na sua configuração

Saiba Mais

Diamante Technical Coaching - Refactor to Grow Newsletter
SammanCoaching.org - Recursos de technical coaching e guias de Learning Hour
Learning Hours - Catálogo de tópicos de Learning Hour
4C Learning Model - Connect, Concept, Concrete, Conclusion
Technical Coaching - Papel e práticas

Solução de Problemas

Erro "Tool not found": Certifique-se de que você reiniciou o Claude Desktop após adicionar a configuração.

"Invalid API key": Verifique se você copiou a chave inteira, incluindo quaisquer prefixos (sk-ant-...).

Quadro Miro não está sendo criado: Verifique se seu MIRO_ACCESS_TOKEN é válido e possui permissões de criação de quadros.

Contribuindo

Consulte CONTRIBUTING.md para configuração de desenvolvimento e diretrizes.

Licença

MIT