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
<PackageReference Include="Bfs.Seed.Mcp" Version="0.11.0" />
<PackageVersion Include="Bfs.Seed.Mcp" Version="0.11.0" />
<PackageReference Include="Bfs.Seed.Mcp" />
paket add Bfs.Seed.Mcp --version 0.11.0
#r "nuget: Bfs.Seed.Mcp, 0.11.0"
#:package Bfs.Seed.Mcp@0.11.0
#addin nuget:?package=Bfs.Seed.Mcp&version=0.11.0
#tool nuget:?package=Bfs.Seed.Mcp&version=0.11.0
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/mcpals HTTP-Function im Paket, Streamable HTTP und zustandslos: Jede Anfrage bekommt einen eigenen Server, ohne Sitzung und ohne Ereignisstrom (GETundDELETEantworten405). So verteilt Flex Consumption die Aufrufe auf beliebig viele Instanzen, undtools/listundtools/callfunktionieren auch ohne vorherigesinitialize. - Metadaten nach RFC 9728 unter
/api/.well-known/oauth-protected-resource, ohne Anmeldung:resource, Entra-Tenant alsauthorization_servers,scopes_supported.AddSeedMcp()setztSeedAuthOptions.ResourceMetadataPath; damit nennt jede 401-Antwort der Token-Prüfung die Metadaten alsresource_metadata. Am Pfad der Wurzel (/.well-known/…) können Functions wegen des Routen-Präfixesapinichts ausliefern; Claude, Claude Code und VS Code folgen dem Header. - Werkzeuge per Attribut aus dem SDK:
[McpServerToolType],[McpServerTool],[Description]. Parameter vom TypClaimsPrincipalbekommen 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
isErroran das Modell, damit es den Aufruf korrigieren kann. - Capabilities je Werkzeug über
[RequireCapability]ausBfs.Seed.Authan 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/listzeigt nur Werkzeuge, deren Anforderungen die Person erfüllt.tools/callauf ein anderes liefert ein Ergebnis mitisErrorund 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)oderWithToolsFromAssemblydazukommen, prüft deshalb auch die App: Fehlt die Angabe, startet sie nicht, und dieInvalidOperationExceptionnennt das Werkzeug und die drei Attribute. Der Endpunkt/api/mcpselbst 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 | Versions 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. |
-
net10.0
- Bfs.Seed.Auth (>= 0.11.0)
- Microsoft.Azure.Functions.Worker (>= 2.51.0)
- Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore (>= 2.1.0)
- ModelContextProtocol.Core (>= 2.2.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.