Build MCP servers in TypeScript with declarative tooling, built-in observability, and pluggable authentication. For developers who want a production-ready template with logging and auth modes out of the box.
io.github.cyanheads/mcp-ts-template
Local install
STDIO
No auth required
How models use it and what it is built for.
Build MCP servers in TypeScript with declarative tooling, built-in observability, and pluggable authentication. For developers who want a production-ready template with logging and auth modes out of the box.
Local install — runs as a subprocess.
Configuration this server reads at startup.
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
The hostname for the HTTP server.
The port to run the HTTP server on.
The endpoint path for the MCP server.
Authentication mode to use: 'none', 'jwt', or 'oauth'.
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
Where to find authoritative docs and source for Cyanheads MCP Ts Template.
Paste any of these into Agent Studio after connecting Cyanheads MCP Ts Template.
Common questions about connecting and running Cyanheads MCP Ts Template.
What authentication modes does this template support?
The template supports three modes via the MCP_AUTH_MODE environment variable: 'none' (no auth), 'jwt' (JSON Web Token), and 'oauth' (OAuth). You configure which mode to use when starting the server.
How do I configure logging and observability?
Set the MCP_LOG_LEVEL environment variable to 'debug', 'info', or 'warn' to control log output verbosity. The template includes built-in observability hooks for monitoring server behavior.
Can I run this server on a custom host and port?
Yes. Use MCP_HTTP_HOST to set the hostname and MCP_HTTP_PORT to set the port. You can also customize the endpoint path with MCP_HTTP_ENDPOINT_PATH.
Is this a template or a ready-to-use server?
This is a template and starter kit for building your own MCP servers in TypeScript. It provides the scaffolding, declarative tooling, and auth/logging infrastructure; you add your own tools and business logic.
What's the difference between this and building an MCP server from scratch?
This template eliminates boilerplate by providing declarative tool registration, pre-configured logging, pluggable authentication, and HTTP server setup. You focus on implementing your tools rather than infrastructure.
MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 30+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.
Open Agent StudioJudges Panel
45 judges that evaluate AI-generated code for security, cost, and quality with built-in AST.
Addozhang Nexus
Query Sonatype Nexus Repository (OSS/Pro) for Maven, Python, and Docker artifacts
Chernistry Bernstein
Declarative agent orchestration for engineering teams
Greptimeteam Greptimedb
Query and analyze GreptimeDB metrics, logs and traces via SQL, TQL and RANGE queries.