Bfs.Seed.Mcp 0.11.0

dotnet add package Bfs.Seed.Mcp --version 0.11.0
                    
NuGet\Install-Package Bfs.Seed.Mcp -Version 0.11.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Bfs.Seed.Mcp" Version="0.11.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Bfs.Seed.Mcp" Version="0.11.0" />
                    
Directory.Packages.props
<PackageReference Include="Bfs.Seed.Mcp" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Bfs.Seed.Mcp --version 0.11.0
                    
#r "nuget: Bfs.Seed.Mcp, 0.11.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Bfs.Seed.Mcp@0.11.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Bfs.Seed.Mcp&version=0.11.0
                    
Install as a Cake Addin
#tool nuget:?package=Bfs.Seed.Mcp&version=0.11.0
                    
Install as a Cake Tool

Bfs.Seed.Mcp

MCP-Server für Azure Functions (dotnet-isolated) in Projekten aus Sentinel Seed. Claude, VS Code und andere KI-Werkzeuge rufen damit im Namen der angemeldeten Person Werkzeuge der API auf. Basis ist das offizielle C#-SDK ModelContextProtocol.Core.

var builder = FunctionsApplication.CreateBuilder(args);
builder.ConfigureFunctionsWebApplication();
builder.AddSeedCore();
builder.UseSeedAuth();
builder.AddSeedMcp()
    .WithToolsFromAssembly(typeof(Program).Assembly)
    .WithInstructions("Rufe zuerst ueberblick_abrufen auf.");
builder.Build().Run();
[McpServerToolType]
public sealed class RechnungTools(RechnungService rechnungen)
{
    [McpServerTool(Name = "rechnung_abrufen", ReadOnly = true), Description("Liefert eine Rechnung mit ihren Positionen.")]
    [RequireCapability("invoices.read")]
    public Task<Rechnung> AbrufenAsync(ClaimsPrincipal user, [Description("Rechnungsnummer, z. B. R-2026-001")] string nummer) =>
        rechnungen.AbrufenAsync(user, nummer);
}

Was das Paket mitbringt

  • Endpunkt /api/mcp als HTTP-Function im Paket, Streamable HTTP und zustandslos: Jede Anfrage bekommt einen eigenen Server, ohne Sitzung und ohne Ereignisstrom (GET und DELETE antworten 405). So verteilt Flex Consumption die Aufrufe auf beliebig viele Instanzen, und tools/list und tools/call funktionieren auch ohne vorheriges initialize.
  • Metadaten nach RFC 9728 unter /api/.well-known/oauth-protected-resource, ohne Anmeldung: resource, Entra-Tenant als authorization_servers, scopes_supported. AddSeedMcp() setzt SeedAuthOptions.ResourceMetadataPath; damit nennt jede 401-Antwort der Token-Prüfung die Metadaten als resource_metadata. Am Pfad der Wurzel (/.well-known/…) können Functions wegen des Routen-Präfixes api nichts ausliefern; Claude, Claude Code und VS Code folgen dem Header.
  • Werkzeuge per Attribut aus dem SDK: [McpServerToolType], [McpServerTool], [Description]. Parameter vom Typ ClaimsPrincipal bekommen die angemeldete Person, Dienste aus der Dependency Injection kommen über Konstruktor oder Parameter. Je Anfrage gilt der Scope der Function-Ausführung.
  • Prüfung der Argumente gegen das Schema, das aus den Parametern entsteht: Typen, Pflichtangaben, Aufzählungen, Längen, Grenzen, Muster, auch verschachtelt. Unbekannte Argumente lehnt der Endpunkt ab, statt sie still zu ignorieren. Fehler gehen als Werkzeugergebnis mit isError an das Modell, damit es den Aufruf korrigieren kann.
  • Capabilities je Werkzeug über [RequireCapability] aus Bfs.Seed.Auth an Methode oder Klasse; mehrere müssen alle erfüllt sein. [RequireAnyRole] verlangt irgendeine App-Rolle, [AllowWithoutRole] gibt ein Werkzeug bewusst für jede angemeldete Person frei, auch ohne Rolle. tools/list zeigt nur Werkzeuge, deren Anforderungen die Person erfüllt. tools/call auf ein anderes liefert ein Ergebnis mit isError und der fehlenden Berechtigung oder Rolle, ein unbekanntes Werkzeug einen JSON-RPC-Fehler.
  • Pflichtangabe im Build und beim Start: Ein Werkzeug ohne eines der drei Attribute bricht den Build mit SEEDAUTH002 ab (Analyzer aus Bfs.Seed.Auth, siehe dessen README). Den Analyzer bekommt nur ein Projekt, das Bfs.Seed.Auth referenziert; Werkzeuge aus einer anderen Assembly, die über WithTools(Type) oder WithToolsFromAssembly dazukommen, prüft deshalb auch die App: Fehlt die Angabe, startet sie nicht, und die InvalidOperationException nennt das Werkzeug und die drei Attribute. Der Endpunkt /api/mcp selbst trägt [AllowWithoutRole]: Ob eine Rolle nötig ist, entscheidet das einzelne Werkzeug.

Anmeldung und Konfiguration

Die Token-Prüfung macht Bfs.Seed.Auth: Der MCP-Endpunkt verlangt per [RequireScope("mcp_access")] den Scope mcp_access, alle anderen Functions weiter access_as_user. Welche Clients der Endpunkt annimmt, legt Auth:AllowedClientIds aus Bfs.Seed.Auth fest; das Terraform-Modul sso trägt dort neben SPA und Custom Connector den MCP-Client und die vorab zugelassenen MCP-Clients ein. Ohne Liste nimmt er jedes gültige Token für die API mit mcp_access an. Ohne Feature sso (Seed:Features:Sso) startet die App mit AddSeedMcp() nicht, und ohne angemeldete Person antwortet der Endpunkt immer mit 401.

Einstellung App-Setting Bedeutung
Mcp:Resource Mcp__Resource Kanonische Adresse auf der eigenen Domain, z. B. https://mcp.example.org/api/mcp; setzt das Terraform-Modul sso mit mcp_custom_domain. Kommt eine Anfrage über diese Domain, nennen die Metadaten sie als resource und den Scope <Adresse>/mcp_access; über den Standardnamen der Function gilt api://<client-id>/mcp_access.
Mcp:ServerName Mcp__ServerName Name in initialize und in den Metadaten, Standard Seed:Project.
Mcp:Instructions Mcp__Instructions Hinweise an das Modell; WithInstructions(...) hat Vorrang.

Claude und Claude Code senden die MCP-Adresse als resource; Entra stellt dann nur ein Token aus, wenn sie Application ID URI der API ist, und das geht nur auf einer im Tenant verifizierten Domain. Einrichtung und Verbinden der Clients beschreibt die README von seed-template.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.11.0 77 11/11/2026
0.10.0 110 11/6/2026
0.9.0 132 10/30/2026
0.8.0 147 10/24/2026
0.7.0 118 10/17/2026
0.6.1 113 10/17/2026
0.6.0 118 10/17/2026
0.5.0 124 10/12/2026
0.4.1 116 10/11/2026
0.4.0 107 10/11/2026
0.3.0 108 10/10/2026