Blazor Blueprint Blazor Blueprint
Previous Theme Playground Next Migrate to v4

MCP Server

New

Model Context Protocol server for AI coding agents. Provides structured access to Blazor Blueprint documentation — 149 styled components, 38 primitives, and 64 blueprints — with semantic search, component APIs, and usage patterns.

Overview

The Model Context Protocol (MCP) is an open standard that enables AI assistants to access external tools and data sources. The Blazor Blueprint MCP server gives AI coding agents like Claude Code direct access to component documentation, making it easier for them to help you build Blazor applications with the library.

Fuzzy Search

Find components by name, description, or keywords using fuzzy matching.

Live Documentation

Fetches the latest documentation with local disk caching for fast access.

Version Pinning

Pin to an archived library version for projects not yet on the latest.

Changelog

Query recent changes and breaking changes to plan upgrades.

Offline Support

Cached docs work without internet after first fetch.

Installation

Run the MCP server directly with npx (requires Node.js 18+): 

npx @blazorblueprint/mcp@latest

Claude Code Integration

Add the MCP server to Claude Code with a single command: 

claude mcp add blazorblueprint --transport stdio -- npx -y @blazorblueprint/mcp@latest

Installation Scopes

Claude Code supports different scopes for MCP server configuration:

Scope Flag Storage Use Case
Local --scope local ~/.claude.json Personal config for one project (default)
Project --scope project .mcp.json Shared with team via git
User --scope user ~/.claude.json Available in all your projects

Project Configuration

To share the MCP server with your team, add it to your repository's .mcp.json file:

.mcp.json
{
  "mcpServers": {
    "blazorblueprint": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@blazorblueprint/mcp"]
    }
  }
}

Claude Desktop Integration

To use with Claude Desktop, add the server to your configuration file:

Edit ~/Library/Application Support/Claude/claude_desktop_config.json: 

{
  "mcpServers": {
    "blazorblueprint": {
      "command": "npx",
      "args": ["-y", "@blazorblueprint/mcp"]
    }
  }
}

Available Tools

The MCP server provides eleven tools that AI agents can use to access Blazor Blueprint documentation:

Tool Description
search_components Fuzzy search for components by name, description, or keywords
get_component Get full documentation for a specific component (parameters, events, examples)
list_components List all components, optionally filtered by category or package
get_setup Get installation and setup instructions
get_patterns Get usage patterns and best practices (forms, theming, data binding)
get_icons Search the icon library or list icon categories
get_primitive Get documentation for unstyled primitive components
list_blueprints List available blueprints, optionally filtered by category
get_blueprint Get full Razor code for a specific blueprint
get_version Check the configured and latest library version
get_changelog Get recent changes, with optional date and breaking-only filters

Tool Examples

Here are examples of how AI agents use each tool:

Search for components matching a query:

{
  "query": "date picker",
  "limit": 5
}

Get full documentation for a component:

{
  "name": "Button"
}

List components by category:

{
  "category": "Inputs"
}

Get setup instructions for a specific hosting model:

{
  "hosting_model": "server",
  "include_theming": true
}

Get best practices for forms:

{
  "pattern": "forms"
}

Search for icons:

{
  "query": "arrow"
}

Get primitive component documentation:

{
  "name": "dialog"
}

List blueprints filtered by category:

{
  "category": "login"
}

Get full Razor code for a specific blueprint:

{
  "name": "login-01"
}

Check the configured and latest library version:

{}

Get recent changes with optional filters:

{
  "since": "2026-02-10",
  "breaking_only": true
}

Configuration

Environment Variables

The MCP server can be configured using environment variables:

Variable Default Description
BLAZORBLUEPRINT_VERSION Latest Pin to an archived library version (e.g., 2)
BLAZORBLUEPRINT_CACHE_TTL 24 Cache TTL in hours
BLAZORBLUEPRINT_CACHE_DIR Platform default Custom cache directory
BLAZORBLUEPRINT_OFFLINE false Force offline mode (use cache only)

Version Pinning

By default the MCP serves the latest documentation. If your project uses an older version of Blazor Blueprint, set BLAZORBLUEPRINT_VERSION to fetch archived docs instead. 

# macOS/Linux
claude mcp add blazorblueprint --transport stdio -e BLAZORBLUEPRINT_VERSION=2 -- npx -y @blazorblueprint/mcp@latest

# Windows
claude mcp add blazorblueprint --transport stdio -e BLAZORBLUEPRINT_VERSION=2 -- cmd /c npx -y @blazorblueprint/mcp@latest

Cache Locations

Documentation is cached locally for offline access. Default cache locations by platform:

Platform Cache Path
Windows %LOCALAPPDATA%/blazorblueprint-mcp/cache/
macOS ~/Library/Caches/blazorblueprint-mcp/
Linux ~/.cache/blazorblueprint-mcp/

Next Steps

Once you've set up the MCP server, your AI coding assistant will be able to access Blazor Blueprint documentation directly. Try asking it to help you build a form, create a dialog, or set up theming.

Previous Theme Playground Next Migrate to v4