MCP-Server-Vorlagen

Produktionsreife MCP-Server-Starter-Vorlagen mit Berechtigungsgrenzen, Integrationstests und Evaluierungsverträgen.

Vorlagen

Vorlage	Beschreibung	Hauptmerkmale
basic	Minimaler MCP-Server	Echo- + Berechnungs-Tools, Zod-Validierung
database	Schreibgeschützter Datenbankzugriff	SQL-Validierung, Schema-Introspektion, Berechtigungsgrenzen
api-gateway	Externer API-Proxy	Ratenbegrenzung, Anmeldeinformations-Scoping, Endpunkt-Konfiguration

Schnellstart

Klone dieses Repository oder verwende „Use this template“ auf GitHub
Navigiere zu der gewünschten Vorlage: cd templates/basic
Installiere die Abhängigkeiten: pnpm install
Starte den Server: pnpm start

Architektur

Jede Vorlage folgt denselben Mustern:

Berechtigungs-Engine — Deklarative Regeln (erlauben/verweigern), die vor jedem Tool-Aufruf ausgewertet werden
In-Memory-Test-Client — Integrationstests über den InMemoryTransport des MCP-SDKs
Evaluierungsverträge — YAML-Evaluierungsspezifikationen, kompatibel mit @visystems/claude-eval-runner

Gemeinsame Dienstprogramme

Das Verzeichnis shared/ enthält wiederverwendbare Dienstprogramme:

permissions/ — Berechtigungsrichtlinientypen, Engine und PermissionDeniedError
testing/ — In-Memory-MCP-Test-Client für Integrationstests
errors/ — Typisierte Fehlerklassen

Entwicklung

pnpm install
pnpm typecheck    # TypeScript type checking
pnpm test         # Run all tests
pnpm test:shared  # Run shared utility tests only
pnpm test:basic   # Run basic template tests only