Skip to content
MCP server

MCP Ts Template

TypeScript framework and template for building MCP servers with auth, storage and logging

Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally or Remotely
Version
3.0.9
Listing updated
today

Similar MCP servers

About MCP Ts Template

MCP Ts Template is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

The README describes this as a TypeScript framework (published as @cyanheads/mcp-ts-core) for turning an API, dataset or workflow into an MCP server. The developer supplies domain code while the framework handles auth, storage, logging and transports. Tools, resources and prompts are declared with typed builders and registered through a single createApp() call.

The project also ships agent skills and a scaffold with CLAUDE.md and AGENTS.md files, so a coding agent can help design, test and release the server. Servers can run on Bun, Node.js 24+ or Cloudflare Workers, over stdio or Streamable HTTP.

The template suits developers who want to build custom MCP servers in TypeScript and prefer built-in linting, contract tests and fuzz testing over assembling that tooling themselves.

Install

Run in a terminal

claude mcp add mcp-ts-template -- npx -y mcp-ts-template

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-ts-template": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ts-template"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-ts-template": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ts-template"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-ts-template": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-ts-template"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-ts-template": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ts-template"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-ts-template": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ts-template"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

What it does

Typed tool builders
Tools, resources and prompts are defined with schema-validated input and output and a handler function.
Declared errors and enrichment
Expected failures and success-path context are declared up front and advertised to clients before they call a tool.
Auth and scoped storage
Per-definition scopes are checked under JWT or OAuth, and tenant-scoped state can use memory, filesystem, Supabase or Cloudflare storage.
Build-time definition linting
A lint command checks names, schemas, scopes, annotations and format parity before deployment.
Testing utilities
Mock contexts, contract checks, fast-check fuzzing and a headless MCP Apps renderer are included for tests.
Observability
Pino structured logs and optional OpenTelemetry traces and metrics are supported.

Good for

  • Wrapping an internal inventory or product API as an MCP server for AI assistants
  • Building a read-only search tool over a catalog or dataset for agents
  • Shipping an MCP server to Cloudflare Workers from the same codebase as a local stdio server
  • Keeping a bulk upstream dataset in a local SQLite mirror that tools can query

Pricing

Open source

Open source; the README links an Apache 2.0 license.

MCP Ts Template FAQ

Which runtimes does the framework support?

The README says servers run on Bun, Node.js 24+ or Cloudflare Workers.

How do I start a new server?

The README shows running bunx @cyanheads/mcp-ts-core init my-mcp-server, then bun install in the new directory.

What transports are supported?

The README lists stdio and HTTP, with the HTTP endpoint on port 3010 at /mcp by default.

Is MCP Ts Template free?

Yes. MCP Ts Template is open source, so you can use and self-host it for free.

How do I add MCP Ts Template to Claude Code?

Run this command in your terminal: claude mcp add mcp-ts-template -- npx -y mcp-ts-template

What are the best alternatives to MCP Ts Template?

The closest alternatives to MCP Ts Template are MCP Server Template, Skybridge Example MCP App, MCP Server Commands, Srecode Template MCP and Dotnet Template MCP.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers