Skip to main content
Glama
demo-mcp-server

demo-mcp-server

demo-mcp-server

Ein Wegwerf-MCP-Server und ein Client-Metadaten-Dokument, die dazu dienen, die OAuth-Autorisierung während der Entwicklung Ende-zu-Ende zu testen. Nichts davon ist Produktionscode.

Der Server

src/ stellt MCP über streamable HTTP bereit, abgesichert durch von Auth0 ausgestellte Bearer-Tokens:

Pfad

Verhalten

POST /mcp

MCP-Endpunkt. Nicht authentifizierte Anfragen erhalten 401 mit einer WWW-Authenticate-Challenge, die das Metadaten-Dokument benennt.

GET /.well-known/oauth-protected-resource/mcp

RFC 9728 Metadaten der geschützten Ressource

Tokens werden anhand des JWKS des Mandanten auf iss, exp und aud geprüft. Ein Token, das keine Organization angibt, wird abgelehnt: Ohne eine solche gibt es keine Teamgrenze, innerhalb derer gearbeitet werden kann. Zwei Tools verlangen unterschiedliche Scopes: whoami benötigt mcp:read und meldet die Identität, die das Token trug; echo benötigt mcp:write. Ein Aufruf mit unzureichendem Scope erzeugt daher einen echten 403 mit insufficient_scope.

nvm use 22 && npm install
npm run dev

Die Einstellungen befinden sich in src/config.ts, und jede davon ist per Umgebungsvariable überschreibbar. Die Ressourcenkennung muss der URL entsprechen, mit der Clients tatsächlich eine Verbindung herstellen; Clients lehnen ein Metadaten-Dokument ab, das etwas anderes angibt.

Related MCP server: MCP Server OAuth Toy

Das Metadaten-Dokument

docs/client.json wird über GitHub Pages veröffentlicht, und seine URL ist die client_id des Clients, gemäß OAuth Client ID Metadata Document und MCP client registration.

Die Weiterleitungs-URIs sind die Standardwerte von MCP Inspector: Port 6276 für die CLI und die TUI, Port 6274 für den Web-Client.

Dieses Repository ist öffentlich, weil ein Autorisierungsserver das Dokument anonym abruft. Es enthält keine Konfiguration und keine Zugangsdaten.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Minimal MCP server for testing SkyStage's self-auth auto-detection feature. It includes tools like ping, echo, server_info, and read_secret, and uses a mock OAuth provider for login.
    -
  • F
    license
    Not graded
    quality
    B
    maintenance
    A simple HTTP-based MCP server that provides demo tools (get_test_string, echo, check_maintenance), greeting prompts, and test resources, with optional OAuth 2.1 support.
    -