MCP profile

Github Cyanheads Mcp Ts Template

A production-grade TypeScript template for scalable MCP servers with built-in observability.

Developer ToolsPackageJavaScript/TypeScriptOpen SourceExternal

Book a demo View source

Last updated

March 16, 2026

Visibility

Public

ByRegistry

About This MCP Server

mcp-ts-template TypeScript template for building Model Context Protocol (MCP) servers. Ships with declarative tools/resources, pluggable auth, multi-backend storage, OpenTelemetry observability, and support for both local and edge (Cloudflare Workers) runtimes. 7 Tools • 2 Resources • 1 Prompt

> Try it live — A public demo instance is running at https://mcp-ts-template.caseyjhand.com/mcp. Connect any MCP client to test the template's tools and resources without installing anything.

Modular, domain-driven layout with clear separation of concerns:

Capabilities

This template includes working examples to get you started.

Why Use Github Cyanheads Mcp Ts Template?

Define tools and resources in single, self-contained files. The framework handles registration.
Tools can prompt users for missing parameters mid-execution via elicitation.
Unified McpError system for consistent, structured error responses.
Auth modes: none, jwt, or oauth. Wrap logic with withToolAuth/withResourceAuth.
Swap storage backends (in-memory, filesystem, Supabase, Cloudflare D1/KV/R2) without changing tool logic. Includes cursor pagination, batch ops, and input validation.
Structured logging (Pino) with optional OpenTelemetry for tracing and metrics.
Custom typed DI container with Token<T> phantom branding. No external deps.
Pluggable service integrations: LLM (OpenRouter), TTS (ElevenLabs).
Parsing helpers (PDF, YAML, CSV, frontmatter), formatting (diffs, tables, trees, markdown), scheduling, security.
Runs on local (stdio/HTTP) and edge (Cloudflare Workers) with the same code.

Specifications

Status

live

Industry

Developer Tools

Requirements

• Bun v1.2.0 or higher.

Hosting

Hosting Options

Package

API

Integrate this server into your application. Choose a connection method below.

Configure

Configuration

json

{
  "mcpServers": {
    "mcp-ts-template": {
      "type": "stdio",
      "command": "bunx",
      "args": ["mcp-ts-template@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "STORAGE_PROVIDER_TYPE": "filesystem",
        "STORAGE_FILESYSTEM_PATH": "/path/to/your/storage"
      }
    }
  }
}

Performance

Usage

Quick Reference

Name: Github Cyanheads Mcp Ts Template
Function: A production-grade TypeScript template for scalable MCP servers with built-in observability.
Transport: Package
Language: JavaScript/TypeScript
Source: External (Registry)
License: Open Source