typescript-mcp

SKILL.md

Build MCP servers with TypeScript on Cloudflare Workers, preventing 20 documented production issues.

Supports tools, resources, prompts, tasks, and three authentication patterns (API keys, OAuth, Zero Trust) with built-in Cloudflare service integrations (D1, KV, R2, Vectorize)

Requires fresh McpServer instance per HTTP request and StreamableHTTPServerTransport for production; SSE transport is deprecated

Prevents critical issues including server instance reuse breaking concurrent sessions, unclosed transport memory leaks, export syntax errors, CORS misconfigurations, and task validation failures

Tasks enable long-running operations with polling; sampling with tools enables server-side agentic behavior using standard MCP primitives

TypeScript MCP on Cloudflare Workers

Last Updated: 2026-01-21
Versions: @modelcontextprotocol/sdk@1.25.3, hono@4.11.3, zod@4.3.5
Spec Version: 2025-11-25

Quick Start

npm install @modelcontextprotocol/sdk@latest hono zod
npm install -D @cloudflare/workers-types wrangler typescript

Transport Recommendation: Use StreamableHTTPServerTransport for production. SSE transport is deprecated and maintained for backwards compatibility only. Streamable HTTP provides better error recovery, bidirectional communication, and simplified deployment.