Mcp Ts Template
Bootstrap a production-minded MCP server repo with tooling, observability, and auth patterns instead of copying random GitHub snippets.
Overview
io.github.cyanheads/mcp-ts-template is a Build-phase MCP starter that scaffolds TypeScript servers with declarative tooling, observability, auth, and stdio or HTTP transport.
What is this MCP server?
- Starter template mcp-ts-template v3.0.9 with declarative tooling and observability
- Auth scaffolding for safer agent-facing servers
- Stdio and streamable-http (localhost:3010/mcp) like mcp-ts-core lineage
- MCP_LOG_LEVEL defaults to info for operator-friendly output
- Bun-oriented npm scripts: run start:stdio or start:http
- Template version 3.0.9
- npm package mcp-ts-template; stdio and http://localhost:3010/mcp
- Default MCP_LOG_LEVEL info via environment configuration
Community signal: 145 GitHub stars.
What problem does it solve?
Starting each MCP server from scratch leaves auth, logging, and transport inconsistent, wasting solo builder time before any real integration ships.
Who is it for?
Solo developers launching their first or second custom MCP server who want cyanheads-style structure without designing the repo from zero.
Skip if: Users who only consume prebuilt MCP servers, or large orgs with an established internal MCP platform that replaces third-party templates.
What do I get? / Deliverables
You get a forkable MCP server skeleton with observability and auth patterns wired for stdio or streamable-http, ready for your tools and client config.
- Forkable MCP server project with declarative tooling and logging baseline
- Auth-oriented structure suitable for agent-exposed tools
- Stdio and HTTP transport entrypoints via npm scripts
Recommended MCP Servers
Journey fit
Templates accelerate Build-phase agent-tooling when you are standardizing how every new MCP service is structured, tested, and operated locally. mcp-ts-template packages opinionated layout—declarative tooling hooks, logging, auth scaffolding—so the first custom MCP server ships faster than greenfield protocol experiments.
How it compares
Opinionated MCP server starter repo, not the core framework alone and not a domain-specific connector.
Common Questions / FAQ
Who is mcp-ts-template for?
Indie TypeScript developers building MCP servers who want auth, logging, and transport layout prewired before adding business tools.
When should I use mcp-ts-template?
Use it at the start of a Build agent-tooling project when you need a consistent server repo faster than assembling mcp-ts-core pieces manually.
How do I add mcp-ts-template to my agent?
Scaffold or install the mcp-ts-template package, customize tools and auth, run start:stdio or start:http, then register your built server in Claude Code, Cursor, or another MCP client.