MCP TypeScript Template

@cyanheads

Basic information

About MCP TypeScript Template

Agent-native TypeScript framework for building MCP servers. Declarative definitions with auth, multi-backend storage, OpenTelemetry, and first-class support for Bun/Node/Cloudflare Workers.

#template #mcp #ts #llm #llm-agent #model-context-protocol #mcp-server#vibe-coder

MCP TypeScript Template config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-ts-template": {
      "command": "bun",
      "args": [
        "run",
        "rebuild",
        "#",
        "clean",
        "+",
        "build",
        "(scripts/clean.ts",
        "+",
        "scripts/build.ts)"
      ]
    }
  }
}

MCP TypeScript Template tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP TypeScript Template 🚀?

The MCP TypeScript Template is an agent-native TypeScript framework and starter project for building MCP servers. It provides declarative tool, resource, and prompt definitions with built-in auth, multi-backend storage, OpenTelemetry observability, and first-class support for Bun, Node.js, and Cloudflare Workers. It is designed to let developers focus on domain logic while the framework handles infrastructure.

How to use MCP TypeScript Template 🚀?

Run bunx @cyanheads/mcp-ts-core init my-mcp-server to scaffold a new project, then cd my-mcp-server && bun install. Use the tool(), resource(), and prompt() builders to define your server’s capabilities and call createApp() in the entry point. Configuration is done via environment variables.

Key features of MCP TypeScript Template 🚀

Declarative tool, resource, and prompt builders with Zod schemas
Unified context for logging, storage, elicitation, and cancellation
Auth modes: none, JWT, or OAuth, checked automatically
Typed error contracts that publish in tools/list
Multi‑backend storage: in‑memory, filesystem, Supabase, Cloudflare D1/KV/R2
Observability with Pino logging and optional OpenTelemetry
Agent‑friendly developer experience with CLAUDE.md and Agent Skills

Use cases of MCP TypeScript Template 🚀

Build a search tool that queries an external API and returns structured results
Expose a database as MCP resources with automatic caching and access control
Create long‑running task tools for operations like data export or report generation
Deploy an MCP server on Cloudflare Workers using the same definitions

Frequently asked questions

What runtimes does the template support?

It supports Bun (v1.3.0+), Node.js, and Cloudflare Workers. Scaffolded projects can use either the standard `createApp()` or `createWorkerHandler()` for Workers.

What transports and auth modes are available?

Transports: `stdio` (default) and `http` (port configurable via `MCP_HTTP_PORT`). Auth modes: `none`, `jwt`, or `oauth` (configured with `MCP_AUTH_MODE` and related variables).

Which storage backends can I use?

Storage providers: `in‑memory` (default), `filesystem`, `supabase`, `cloudflare‑d1`, `cloudflare‑kv`, and `cloudflare‑r2`. Switch via the `STORAGE_PROVIDER_TYPE` env var.

How do I define a tool with structured output?

Use the `tool()` builder with a Zod `output` schema. Structured content is available to clients that support it. Add a `format()` method to render markdown for clients that only read `content[]`. A linter (run via `lint:mcp`) checks parity between the two surfaces.

Can I deploy on Cloudflare Workers?

Yes. The framework provides `createWorkerHandler()`, which returns an `ExportedHandler`. Use the same tool, resource, and prompt definitions — only the entry point differs.

Comments

More Developer Tools MCP servers

Launchdog

Devin Starks

Launch your product from your AI agent. Connect Claude Code, Codex, Cursor or ChatGPT to Launchdog over MCP and your agent drafts the listing, picks a launch week and books it. 50 launches a week, ranked only by human vo

Cronwatch

cronwatchdev

CronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.

Eddyter AI Rich Text Editor MCP

EddyterAI

Set up and manage the Eddyter AI rich text editor by talking to your AI agent — for Claude, Cursor, Codex and other MCP tools. A Model Context Protocol server that lets AI tools add Eddyter to a React, Next.js, Vite or R

Termany

thinkany-ai

Agent-Native Terminal

174

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.