1. Conduid
  2. Developer Tools
  3. Mcpdemos
MCP server · Developer Tools

Mcpdemos

by · github.com/leestott/mcpdemos

MCP Demos - 8 Node.js/TypeScript demos showcasing Model Context Protocol capabilities, from text-only tools to interactive UIs with bidirectional communication. Covers elicitation, OAuth consent flows, async progress tracking, cancel/retry, MCP App resources (ui://), and report export. No external dependencies required. Includes 5-minute and 15-min

Unclaimed MIT last commit 8 months ago mcp-clientdevtoolsmcpmcp-server
InstallView source
61Good

Scored 5 months ago · breakdown

About Mcpdemos

Mcpdemos is an MCP server published by leestott in the Developer Tools category: mCP Demos - 8 Node.js/TypeScript demos showcasing Model Context Protocol capabilities, from text-only tools to interactive UIs with bidirectional communication. Covers elicitation, OAuth consent flows, async progress tracking, cancel/retry, MCP App resources (ui://), and report export. No external dependencies required. Includes 5-minute and 15-min.

The repository has 4 stars and 0 forks, with the last commit 8 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/leestott/mcpdemos

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Mcpdemos

Powered by Claude · Grounded in docs

I know everything about Mcpdemos. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 3 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

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

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

README fetched from the repository 3 days ago. The original is authoritative.

Questions

About Mcpdemos

How do I install Mcpdemos?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Mcpdemos safe to use with an AI agent?

Its trust score is 61 out of 100 (good). It passes 4 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Mcpdemos still maintained?

The last commit was 8 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.