cyanheads avatar

Mcp Ts Template

cyanheads/mcp-ts-template

A production-grade TypeScript framework for building MCP servers, not a template you fork. Install it as a dependency and use declarative builders (tool, resource, prompt) with Zod schemas while the framework handles auth, telemetry, storage, and transport. The standout feature is the typed error contract system: declare errors with reason codes and recovery hints, get type-safe ctx.fail() in handlers, and clients see failure modes in tools/list. Enrichment fields automatically merge into both structuredContent and content arrays so Claude Code and Claude Desktop both render context without manual formatting. Includes a build-time linter that validates schemas, auth scopes, and format parity. Ships with agent skills and scaffolding for the full development cycle from design through publishing.

GitHub stars
145
tool
1
transport
STDIO, HTTP
env vars
5
last updated
Mar 9, 2026

Tools

1 tools

Public tool metadata for what this MCP can expose to an agent.

catalog_searchSearch catalog item names. An empty query lists all items.

Search catalog item names. An empty query lists all items.

No parameter schema in public metadata yet.

Sponsors

Configuration

MCP_LOG_LEVELdefault: info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

MCP_HTTP_HOSTdefault: 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault: 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault: /mcp

The endpoint path for the MCP server.

MCP_AUTH_MODEdefault: none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

Readme

@cyanheads/mcp-ts-core

Agent-native TypeScript framework for building MCP servers.

Runtime infrastructure for your server, and the agent skills to build, test, and ship it.


Build AI tools for anything you can describe


View the full README on GitHub

Details

Repository
github.com/cyanheads/mcp-ts-template
Category
Monitoring & Observability
Package
mcp-ts-template
Transport
STDIO, HTTP
Registry
MCP registry, active

More from cyanheads

Related Monitoring & Observability MCP servers

View all
1devcrabs-inc avatarYandex Metrikadevcrabs-inc/yandex-metrika-mcpRead-only Yandex Metrika (Яндекс Метрика) analytics: verifiable reports, comparisons and exports.127stars
2amekala avatarAdsamekala/ads-mcpManage Google, Meta, Amazon, TikTok, LinkedIn & ChatGPT ads. 430 tools for campaigns & analytics.106stars
3hypequery avatarhypequery ClickHousehypequery/hypequeryGoverned ClickHouse analytics for agents: named datasets and metrics as tools, never raw SQL.104stars
4akutishevsky avatarNutrition MCPakutishevsky/nutrition-mcpNutrition tracking: log meals and macros, USDA and Open Food Facts lookups, history, app import.90stars
5rootly-ai-labs avatarRootlyrootly-ai-labs/rootly-mcp-serverIncident management, on-call scheduling, and intelligent analysis powered by Rootly.42stars
6pete-builds avatarUniFi Gatewaypete-builds/mcp-unifiSafe-by-default UniFi MCP: Network + Protect + Access, multi-site, dry-run, audit log.31stars