cyanheads avatar

Mcp Ts Core

cyanheads/mcp-ts-core

A TypeScript framework for building MCP servers, not a server itself. You install it as a dependency and use its declarative builders to define tools, resources, and prompts with Zod schemas. The framework handles transports (stdio, HTTP), auth (JWT, OAuth), storage backends, OpenTelemetry tracing, and graceful shutdown. Two standout features: enrichment contracts that automatically populate both structuredContent and content arrays so Claude Code and Claude Desktop both get context, and typed error contracts where you declare failure modes upfront and the linter checks your handler against them. Runs on Bun, Node, and Cloudflare Workers. Reach for this when you want to build domain logic without writing plumbing code.

GitHub stars
153
tool
1
transport
STDIO, HTTP
env vars
6
last updated
Nov 8, 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_TRANSPORT_TYPEdefault: http

Selects the HTTP transport.

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-core
Category
AI & LLM Tools
Package
@cyanheads/mcp-ts-core
Transport
STDIO, HTTP
Registry
MCP registry, active

More from cyanheads

Related AI & LLM Tools MCP servers

View all
1avinash-jetwani avatarjevmemavinash-jetwani/jevmemShared project rules and memory for AI coding agents: a JEVMEM.md in git, with a command guard.148stars
2yokingma avatarOne Search Mcpyokingma/one-search-mcpWeb search, URL discovery, scraping & extraction with agent-browser and search providers148stars
3ticktockbent avatarCharlotteticktockbent/charlotteRenders web pages into structured, agent-readable representations using headless Chromium.147stars
4skillmds avatarSkillmdskillmds/skillmdSearch, fetch, lint, and install Agent Skills (SKILL.md) from the SkillMD registry.144stars
5njohansen avatarhandle-mcpnjohansen/handle-mcpYour AI agent fills the cheapest cart at nemlig.com, BilkaToGo and REMA 1000. You pay.134stars
6rtmandreyev avatarConstructrtmandreyev/constructChecks an agent's part-by-part description of a thing and builds it as glTF, OBJ, 3MF or STL.121stars