Skip to main content
Glama
demo-mcp-server

demo-mcp-server

demo-mcp-server

Un documento de metadatos desechable de un servidor MCP y su cliente, utilizado para probar la autorización OAuth de extremo a extremo durante el desarrollo. Nada de esto es código de producción.

El servidor

src/ sirve MCP sobre Streamable HTTP, protegido por tokens de portador emitidos por Auth0:

Path

Comportamiento

POST /mcp

Endpoint MCP. Las solicitudes no autenticadas reciben un 401 con un desafío WWW-Authenticate que referencia el documento de metadatos

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

Metadatos de recurso protegido RFC 9728

Los tokens se verifican contra el JWKS del tenant en iss, exp y aud, y se rechaza un token que no designe ninguna Organization: sin ella no hay ningún límite de equipo dentro del que trabajar. Dos herramientas exigen alcances distintos — whoami necesita mcp:read e informa de la identidad que portaba el token; echo necesita mcp:write —, por lo que una llamada con un alcance insuficiente produce un 403 real con insufficient_scope.

nvm use 22 && npm install
npm run dev

Los ajustes se encuentran en src/config.ts y todos pueden sobrescribirse mediante variables de entorno. El identificador de recurso debe coincidir con la URL a la que los clientes se conectan realmente; los clientes rechazan un documento de metadatos que designe cualquier otra cosa.

Related MCP server: MCP Server OAuth Toy

El documento de metadatos

docs/client.json se publica mediante GitHub Pages y su URL es el client_id del cliente, según OAuth Client ID Metadata Document y MCP client registration.

Las URI de redirección son los valores predeterminados de MCP Inspector: el puerto 6276 para la CLI y la TUI, y el puerto 6274 para el cliente web.

Este repositorio es público porque un servidor de autorización obtiene el documento de forma anónima. No contiene configuración ni credenciales.

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.
    -