mcp-server-playground

Overview

This is a comprehensive MCP server playground built with TypeScript that implements HTTP-based transport with SSE resumability. It features OAuth authentication/authorization with support for third-party providers like Auth0, GitHub, and Google. The server includes various tools for AWS services (ECS, S3), system operations (time, echo), and data streaming capabilities. It supports pluggable storage abstractions and stateful sessions across multiple server instances using Valkey for persistence. The architecture documentation is thorough, with detailed explanations of how OAuth integration works with dynamic client registration while addressing security concerns.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• aws-ecs

  Investigate the ECS service, task and cloudwatch logs using AWS ECS, Cloudwatch Logs and Bedrock

  Try:Investigate my ECS service for errorsTry:Check recent Cloudwatch logs for my ECS tasks
• aws-s3

  Get the list of S3 buckets and objects

  Try:List all my S3 bucketsTry:Show objects in my bucket 'documents'
• system-time

  Get the current system time in various formats with timezone support

  Try:What's the current time in New York?Try:Show me the time in UTC format
• echo

  Echo a message back with transformations, repetition

  Try:Echo 'Hello World' three timesTry:Transform 'test' to uppercase
• streaming

  Simulate real-time streaming data with live updates

  Try:Show me real-time stock dataTry:Simulate a live temperature stream
• project

  Find keywords in the current project directory

  Try:Find all TODO comments in my projectTry:Search for 'API' in all TypeScript files

Comparable tools

Installation

git clone <your-repo>
cd mcp-server-playground

curl -fsSL https://bun.sh/install | bash

bun install

cp .env.example .env

bun run dev:setup

{
  "mcpServers": {
    "mcp-server-playground": {
      "command": "bun",
      "args": ["run", "start"],
      "env": {
        "PORT": "3000"
      }
    }
  }
}

FAQ

How does this server handle OAuth authentication?

The server implements an OAuth proxy that delegates authorization to third-party providers like Auth0. This enables dynamic client registration while maintaining security by preventing abuse of public registration endpoints.

Can this server be deployed as a cluster with stateful sessions?

Yes, the server supports stateful sessions across multiple instances using Valkey to store session data. When a request comes to a different server instance, it checks if the session exists in Valkey and replays the initial request if needed.

Compare mcp-server-playground with