MCP Ts Template
TypeScript framework and template for building MCP servers with auth, storage and logging
- 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-templateAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-ts-template": {
"command": "npx",
"args": [
"-y",
"mcp-ts-template"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-ts-template": {
"command": "npx",
"args": [
"-y",
"mcp-ts-template"
]
}
}
}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.