A TypeScript boilerplate for building MCP servers with streamable HTTP and OAuth proxy support.
A playground for Model Context Protocol (MCP) server built with TypeScript and Streamable HTTP transport with an OAuth Proxy for 3rd party authorization servers like Auth0.
@modelcontextprotocol/sdk
with HTTP transport, session management, and tool execution.echo
, system-time
, streaming
, project
for demonstration.echo
Endpoint | Description |
---|---|
GET /ping | Ping the server |
POST /mcp | MCP protocol request with authentication |
DELETE /mcp | Session termination |
GET /.well-known/oauth-authorization-server | OAuth authorization server metadata |
GET /.well-known/oauth-protected-resource | OAuth protected resources metadata |
POST /oauth/register | Register a new MCP client |
GET /oauth/authorize | Handle authorization request |
POST /oauth/token | Handle token request |
POST /oauth/revoke | Handle token revocation |
GET /oauth/stats | Get OAuth service statistics |
GET /oauth/auth0-callback | Handle Auth0 callback |
Clone the repository:
git clone <your-repo>
cd mcp-server-playground
Install dependencies:
npm install
Set up environment variables:
cp .env.example .env
Set up the MCP server for local development
npm run dev:setup
helm repo add chrisleekr https://chrisleekr.github.io/helm-charts/
helm repo update
helm install mcp-server-playground chrisleekr/mcp-server-playground
Create MCP configuration file for local build
Create a .cursor/mcp.json
file in your project directory (for project-specific setup) or ~/.cursor/mcp.json
in your home directory (for global setup):
{
"mcpServers": {
"mcp-server-playground-cursor": {
"type": "http",
"url": "http://localhost:3000/mcp"
}
}
}
npx @modelcontextprotocol/inspector
to test the MCP serverCopy mcp-config.example.json
to mcp-config.json
Edit mcp-config.json
to point to the correct MCP server
Run the inspector
npm run docker:run
# Then run the inspector
npx @modelcontextprotocol/inspector -y --config ./mcp-config.json --server mcp-server-playground-cursor
or
npm run test:inspector
Create a new application in Auth0
Set up the application
http://localhost:3000/oauth/auth0-callback
http://localhost:3000
Create a new API
urn:mcp-server-playground
Metadata Discovery | Client Registration | Preparing Authorization |
---|---|---|
Authorization with 3rd party server | Request Authorization and acquire authorization code | Token Request and Authentication Complete |
---|---|---|
Interact with Odoo instances using the XML-RPC API. Requires configuration via environment variables or config files.
Provides interactive user feedback and command execution for AI-assisted development.
Access documentation from the Awesome-llms-txt repository directly in your conversations.
An autonomous memory management system for Claude AI, featuring multi-provider LLM integration and a persistent memory database.
A comprehensive MCP server for managing OPNsense firewalls, offering over 300 tools for configuration and monitoring.
A platform-agnostic server for scalable mobile automation and development across iOS, Android, simulators, and emulators.
Access and interact with Harness platform data, including pipelines, repositories, logs, and artifact registries.
An MCP server with integrations for GitLab, Jira, Confluence, and YouTube, providing AI-powered search and development utility tools.
Integrates with the Stability AI API for image generation, editing, and upscaling.
A Model Context Protocol (MCP) server that enables AI assistants to integrate with Prometheus Alertmanager