Skip to main content
Glama
deenesjakoruzh
chingyangtseng-houzz

demo-mcp-server

by chingyangtseng-houzz
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

demo-mcp-server

A throwaway MCP server and client metadata document, used to exercise OAuth authorization end to end during development. Nothing here is production code.

The server

src/ serves MCP over streamable HTTP behind Auth0-issued bearer tokens:

Path

Behaviour

POST /mcp

MCP endpoint. Unauthenticated requests get 401 with a WWW-Authenticate challenge naming the metadata document

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

RFC 9728 protected resource metadata

Tokens are verified against the tenant JWKS on iss, exp and aud, and a token naming no Organization is refused: without one there is no team boundary to work within. Two tools demand different scopes — whoami needs mcp:read and reports the identity the token carried, echo needs mcp:write — so an under-scoped call produces a real 403 with insufficient_scope.

nvm use 22 && npm install
npm run dev

Settings live in src/config.ts and every one is overridable by environment variable. The resource identifier must equal the URL clients actually connect to; clients reject a metadata document that names anything else.

Related MCP server: MCP Server OAuth Toy

The metadata document

docs/client.json is published via GitHub Pages and its URL is the client's client_id, per OAuth Client ID Metadata Document and MCP client registration.

The redirect URIs are MCP Inspector defaults: port 6276 for the CLI and TUI, port 6274 for the web client.

This repository is public because an authorization server fetches the document anonymously. It contains no configuration or credentials.

This server cannot be installed

F
license - not found
Not graded
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • SkyStage MCP Test Server

    mallikarjun-angadi
    F
    license
    Not graded
    quality
    C
    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.

  • simple-mcp

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

View all related MCP servers

Related MCP Connectors

  • google-mcp

    Streamable HTTP MCP server for Google Calendar and Sheets with OAuth login.

  • Sensact

    An authenticated remote MCP server for user-owned devices and one-shot capability invocation.

  • cortex-gateway

    Self-hosted federated MCP gateway: one OAuth 2.1 MCP server in front of N apps, user-level scopes.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chingyangtseng-houzz/demo-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server