analyze_repository
Analyze a GitHub repository to find real code examples for Learning Hours
LABSCO SUMMARY
Session material built from the team's own code, not a textbook's.
Generating a plan about Feature Envy is the easy half; the half that makes a session land is finding Feature Envy in the repository the team ships every day, which is what the repository analysis does — it returns actual files and line ranges to refactor. The board tool then turns the plan into a Miro workshop, so preparation ends where facilitation starts. Two of the five tools stay dark until you add the matching token.
What it is
A content generator for Technical Coaches running Learning Hours: structured 60-minute practice sessions built on the 4C model — Connect, Concept, Concrete, Conclusion. It writes the session, the code to practise on, and the board to run it from.
What you get
- A full session plan for a named topic, following the 4C model from the opening connection activity through concept, hands-on exercise and closing reflection
- Before and after code examples for a topic in the language you name, so the exercise has something concrete to refactor
- A Miro board created from the session content, turning the plan into a workshop surface the team can work on together
- Real examples of a named code smell — Feature Envy, Long Method, Duplicate Code — located in a GitHub repository you point at, with file and line references
- A read of a repository's tech stack, so the generated content uses the frameworks and test tools the team already works in
Requirements
An Anthropic API key in ANTHROPIC_API_KEY — it is the only required one, and the generated content bills to it. Two optional tokens each unlock a tool: MIRO_ACCESS_TOKEN from a Miro app for board creation, and GITHUB_TOKEN with repo read access for the repository and tech-stack analysis. It starts over stdio as npx -y learning-hour-mcp. MIT.
Setup effort
One command plus a key — npx -y learning-hour-mcp, then supply credentials
USE CASES
01
Preparing next week's Learning Hour on a named refactoring
Generate the 60-minute plan around the 4C model, then generate before/after code in the team's language to practise on.
02
Running the session on a shared board
Hand the generated session content straight to Miro and get a board laid out from it, rather than rebuilding the plan by hand in frames.
03
Teaching a code smell using the team's own code
Point at the repository and name the smell; what comes back is real occurrences with file and line references to use as the exercise.
04
Making the content fit the stack the team actually uses
Read the repository's languages, frameworks and test tools first, so the examples are written in those rather than in a generic sample project.
5 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
analyze_tech_stack
Analyze a repository's technology stack to create team-specific Learning Hour content
create_miro_board
Create a Miro board from Learning Hour session content
generate_code_example
Generate detailed before/after code examples for a learning topic
generate_session
Generate comprehensive Learning Hour content for Technical Coaches
BEFORE YOU INSTALL
What to know first
Tools you get
5 tools when we connected; the project documents 8.
Requires
- npx on PATH
- ANTHROPIC_API_KEY in your environment
Where it runs
All 3 documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y learning-hour-mcpMCP Clients
Claude Desktop, Cursor
JSON
{
"mcpServers": {
"learning-hour": {
"command": "npx",
"args": [
"-y",
"learning-hour-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"MIRO_ACCESS_TOKEN": "<YOUR_MIRO_ACCESS_TOKEN>",
"GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"learning-hour": {
"command": "npx",
"args": [
"-y",
"learning-hour-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"MIRO_ACCESS_TOKEN": "<YOUR_MIRO_ACCESS_TOKEN>",
"GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
}
}
}
}
