How do I use mcpdemos?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcpdemos run the polite CLI demo" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcpdemos

by leestott

Overview Schema Related Servers Score Discussions

TypeScript

Local

MCP Demos

8 runnable demos showcasing Model Context Protocol capabilities - from text-only tools to interactive MCP Apps with bidirectional communication.

Quick Start

node --version   # Requires Node 20+
npm install
npm run dev      # Start MCP server (stdio transport)

For production:

npm run build
npm start

VS Code Configuration

Add to .vscode/settings.json to auto-discover the server:

{
  "mcp": {
    "servers": {
      "mcpdemos": {
        "command": "node",
        "args": ["dist/index.js"],
        "cwd": "${workspaceFolder}"
      }
    }
  }
}

For development with tsx:

{
  "mcp": {
    "servers": {
      "mcpdemos": {
        "command": "npx",
        "args": ["tsx", "src/index.ts"],
        "cwd": "${workspaceFolder}"
      }
    }
  }
}

Demos

#	Demo	Category	Tools	Resources
1	Polite CLI vs Teammate	Hook	`demo1_polite_cli`	-
2	Elicitation Mid-Flow	Negotiation	`demo2_scaffold_start`, `demo2_scaffold_confirm`	-
3	Secure OAuth Handoff	Security	`demo3_request_consent`, `demo3_approve_consent`, `demo3_protected_action`	-
4	Async Progress	Coordination	`demo4_start_pipeline`, `demo4_check_progress`	-
5	Cancel / Retry / Resume	Coordination	`demo5_cancel_task`, `demo5_retry_task`, `demo5_list_tasks`	-
6	Colour Picker	Shared Artifacts	`demo6_save_color`, `demo6_get_palette`	`ui://color-picker`
7	Component Gallery	Shared Artifacts	`demo7_gallery_state`	`ui://component-gallery`
8	Export Artifacts	Platform	`demo8_export_report`, `demo8_list_exports`	-

Runbooks

ShowRun All Demos - All Demos Walkthrough Script
5-Minute Runbook - Quick highlights (Demos 1, 2, 3, 4, 6, 8)
15-Minute Runbook - Full walkthrough with stage timing for all 8 demos

Architecture

src/
  index.ts                     ← Server entry point (stdio transport)
  demos/
    demo1-polite-cli.ts        ← Tool: verbose CLI responses
    demo2-elicitation.ts       ← Tools: scaffold start + confirm
    demo3-oauth.ts             ← Tools: consent → approve → action
    demo4-async-progress.ts    ← Tools: pipeline + progress polling
    demo5-cancel-retry.ts      ← Tools: cancel, retry, list tasks
    demo6-color-picker.ts      ← Tool + Resource: colour picker UI
    demo7-component-gallery.ts ← Tool + Resource: gallery UI
    demo8-export-artifacts.ts  ← Tool: report generation
examples/
  demo{1-8}/README.md          ← Per-demo docs with stage scripts
docs/
  5-minute-runbook.md
  15-minute-runbook.md
outputs/                        ← Generated reports (Demo 8)

Graceful Degradation

If a host doesn't support MCP Apps (ui:// resources), all demos fall back to text-only tool interactions. The UI resources are optional enhancements.

Dependencies

@modelcontextprotocol/sdk - MCP server framework
zod - Schema validation
tsx (dev) - TypeScript execution
No external APIs, databases, or cloud services required

Licence

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

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/leestott/mcpdemos'

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