BootstrapBlazor.MCPServer

View on GitHub

BootstrapBlazor Documents & Source Code MCP Server for Copilot

7 stars C#Servers & Infrastructure Updated Oct 16, 2025

Documentation

BootstrapBlazor MCP Server

中文版 | English

A Model Context Protocol (MCP) Server built on ASP.NET Core and BootstrapBlazor that provides AI assistants (such as Claude, Cursor, Dify, FastGPT, etc.) with intelligent access to the full BootstrapBlazor component library documentation, including API parameters and live code samples.

✨ Features

🔄 Auto Git Sync — Periodically clones/pulls the official BootstrapBlazor repository on a configurable cron schedule.
📄 Doc Extraction — Automatically extracts component API tables (via reflection + XML docs) and Razor/C# code samples into Markdown files, ready for RAG.
🤖 MCP Tools — Exposes standard MCP tools (`GetComponentList`, `SearchComponentKeyword`, `GetComponentDocs`, `AskComponentExpert`) for any MCP-compatible AI client.
🌐 REST API — Provides HTTP endpoints for non-MCP integrations (Dify, FastGPT, custom agents).
🧠 Optional AI Q&A — Integrates with any OpenAI-compatible API to answer natural-language questions about BootstrapBlazor components.
🖥️ Admin UI — A built-in Blazor management dashboard (with login protection) to configure settings, trigger syncs, and monitor status.
🌍 i18n Support — UI supports both `zh-CN` and `en-US` locales.
🐳 Docker Ready — Ships with a `Dockerfile` for one-command deployment.

🏗️ Architecture

code

┌────────────────────────────────────────────────────────┐
│                  BootstrapBlazor.McpServer              │
│                                                        │
│  ┌──────────────┐   ┌──────────────────────────────┐  │
│  │ GitSync Job  │──▶│   DocsExtractorService        │  │
│  │ (Coravel     │   │  (Reflection + XML + Razor)   │  │
│  │  Cron)       │   └────────────┬─────────────────┘  │
│  └──────────────┘                │ Markdown Files      │
│                                  ▼                     │
│  ┌──────────────────────────────────────────────────┐  │
│  │              McpService (MCP Tools)               │  │
│  │  GetComponentList | SearchComponentKeyword        │  │
│  │  GetComponentDocs | AskComponentExpert            │  │
│  └──────┬────────────────────────┬──────────────────┘  │
│         │                        │                     │
│         ▼                        ▼                     │
│  ┌─────────────┐      ┌──────────────────────┐        │
│  │  MCP / SSE  │      │  REST HTTP API        │        │
│  │  /mcp       │      │  /api/components/...  │        │
│  └─────────────┘      └──────────────────────┘        │
└────────────────────────────────────────────────────────┘

🚀 Quick Start

Prerequisites

.NET 10 SDK
Git (installed and available in PATH)

Run Locally

bash

git clone https://github.com/your-org/BootstrapBlazor.McpServer.git
cd BootstrapBlazor.McpServer

# Edit appsettings.json with your configuration (see Configuration section)
dotnet run

The server starts at `http://localhost:5251` by default.

Run with Docker

bash

docker build -t bootstrapblazor-mcp .

docker run -d \
  -p 5251:5251 \
  -e GitSync__RepositoryUrl="https://gitee.com/LongbowEnterprise/BootstrapBlazor.git" \
  -e GitSync__CronSchedule="0 3 * * *" \
  -e GitSync__OutputDir="/app/data/OutputRAG" \
  -e AI__BaseUrl="https://api.openai.com/v1" \
  -e AI__ApiKey="YOUR_API_KEY" \
  -e AI__Model="gpt-4o" \
  -v /your/data/path:/app/data \
  bootstrapblazor-mcp

⚙️ Configuration

Edit `appsettings.json` or use environment variables (Docker-friendly):

json

{
  "GitSync": {
    "RepositoryUrl": "https://gitee.com/LongbowEnterprise/BootstrapBlazor.git",
    "CronSchedule": "0 3 * * *",
    "LocalPath": "/app/data/BootstrapBlazorRepo",
    "OutputDir": "/app/data/OutputRAG"
  },
  "AI": {
    "BaseUrl": "https://api.openai.com/v1",
    "ApiKey": "YOUR_API_KEY_HERE",
    "Model": "gpt-4o"
  }
}

Key	Description	Default
`GitSync:RepositoryUrl`	URL of the BootstrapBlazor source repository	Gitee mirror
`GitSync:CronSchedule`	Cron expression for auto-sync	`0 3 * * *` (3 AM daily)
`GitSync:LocalPath`	Local path to clone the repo into	`/app/data/BootstrapBlazorRepo`
`GitSync:OutputDir`	Output directory for generated Markdown	`/app/data/OutputRAG`
`AI:BaseUrl`	OpenAI-compatible API base URL	`https://api.openai.com/v1`
`AI:ApiKey`	API key for the AI service	—
`AI:Model`	Model name to use	`gpt-4o`

🔌 MCP Integration

Connecting from Claude Desktop

Add the following to your Claude Desktop config (`claude_desktop_config.json`):

json

{
  "mcpServers": {
    "bootstrapblazor": {
      "url": "http://localhost:5251/mcp"
    }
  }
}

Connecting from Cursor

In Cursor settings, add an MCP server pointing to `http://localhost:5251/mcp`.

Available MCP Tools

Tool	Description
`GetComponentList`	Returns a list of all available BootstrapBlazor components
`SearchComponentKeyword`	Searches for components matching a keyword
`GetComponentDocs`	Returns the raw API table + code samples for a component
`AskComponentExpert`	Answers a natural-language question about a component (uses AI if enabled)

🌐 REST API

For non-MCP integrations (e.g., Dify, FastGPT):

Method	Endpoint	Description
`GET`	`/api/components`	List all component names
`GET`	`/api/components/search?keyword={kw}`	Search components by keyword
`GET`	`/api/components/{name}/docs`	Get raw docs for a component
`GET`	`/api/components/{name}/ask?q={question}`	Ask an AI-powered question

🖥️ Admin Dashboard

Navigate to `http://localhost:5251` to access the Blazor admin UI. Log in with the credentials configured in `appsettings.json` (default: see your settings).

Features:

View and edit server configuration
Manually trigger Git sync
Monitor sync status and logs
Toggle AI integration on/off

🛠️ Tech Stack

Layer	Technology
Framework	ASP.NET Core (.NET 10)
UI	BootstrapBlazor (Blazor Server)
MCP	ModelContextProtocol SDK 0.9
AI Integration	Microsoft.Extensions.AI + OpenAI
Git Sync	LibGit2Sharp
Scheduling	Coravel
i18n	ASP.NET Core Localization

📁 Project Structure

code

BootstrapBlazor.McpServer/
├── Components/         # Blazor UI components (Admin pages, App shell)
├── Services/
│   ├── McpService.cs           # MCP tool definitions
│   ├── DocsExtractorService.cs # Docs extraction logic (reflection + XML + Razor)
│   ├── GitSyncInvocable.cs     # Git clone/pull + trigger extraction
│   ├── AiIntegrationService.cs # OpenAI-compatible HTTP client
│   └── AppSettingsManager.cs   # Read/write appsettings.json at runtime
├── Locales/            # i18n JSON files (zh-CN, en-US)
├── Program.cs          # App startup & endpoint mapping
├── Dockerfile          # Container build definition
└── appsettings.json    # Default configuration

📄 License

This project is licensed under the MIT License. See LICENSE for details.

🤝 Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Frequently asked questions

What is BootstrapBlazor.MCPServer?

BootstrapBlazor.MCPServer is BootstrapBlazor Documents & Source Code MCP Server for Copilot

How do I install BootstrapBlazor.MCPServer?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is BootstrapBlazor.MCPServer open source?

Yes — it is hosted on GitHub at https://github.com/bootstrapblazor/bootstrapblazor.mcpserver and has 7 stars.

Related MCP tools

unity-mcp

An MCP server that allows MCP clients like Claude Desktop or Cursor to perform actions in the Unity Editor C#-based implementation.

3,727 C#

aiai-integrationanthropic+15

csharp-sdk

The official C# SDK for Model Context Protocol servers and clients. Maintained in collaboration with Microsoft. Trusted by 3500+ developers.

3,512 C#

mcp-unity

Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for OpenAI, Gemini, Claude, Deepseek and Grok interoperability

1,061 C#

aiclaude-aiclaudecode+13

playwright-mcp

Playwright MCP server TypeScript-based implementation. Trusted by 22000+ developers. Trusted by 22000+ developers. Trusted by 22000+ developers.

22,066 TypeScript

mcpplaywright

ghidramcp

MCP Server for Ghidra Java-based implementation. Trusted by 6400+ developers. Trusted by 6400+ developers. Trusted by 6400+ developers.

6,409 Java

notion-mcp-server

Official Notion MCP Server TypeScript-based implementation. Trusted by 3400+ developers. Trusted by 3400+ developers. Trusted by 3400+ developers.

3,419 TypeScript

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP