learnblazor

A Blazor Server web application built with .NET 10 that provides a web interface for searching Microsoft Learn documentation via the Learn MCP Server.

Prerequisites

• .NET 10 SDK

Getting Started

dotnet run --project learnwasm

The app will be available at https://localhost:5001 (or the port shown in the terminal).

Running Tests

dotnet test

Project Structure

learnwasm.sln
learnwasm/                  # Blazor Server web app
  Components/
    Layout/                 # Shared layout components (MainLayout, NavMenu)
    Pages/                  # Page components (Home, Error, NotFound)
    App.razor               # Root application component
  wwwroot/                  # Static assets (CSS, images, JS libs)
  Program.cs                # Application entry point and service configuration
learnwasm.Tests/            # xUnit + bUnit test project
  HomePageTests.cs          # Component tests for the Home page
  McpServerIntegrationTests.cs  # Integration tests against the live MCP API

Tech Stack

• Blazor Server with Interactive Server render mode
• .NET 10
• xUnit and bUnit for testing
• GitHub Actions for CI/CD to Azure

Deployment

The app is deployed to Azure App Service via GitHub Actions (.github/workflows/main_learnblazor.yml).

The Azure Web App has a startup command configured: dotnet learnwasm.dll. This is required because the publish output would otherwise be ambiguous to the runtime.