mcp-ts-core

Overview

@cyanheads/mcp-ts-core is a comprehensive TypeScript framework for building MCP servers. It provides declarative tools, resources, and prompt definitions with built-in support for authentication, multi-backend storage, and observability. The framework handles infrastructure plumbing like transports, config, logging, and telemetry, allowing developers to focus on domain-specific logic. It supports multiple runtimes including Bun, Node.js, and Cloudflare Workers, with optional features like DataCanvas for analytical workspaces.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• greet

  Greet someone by name and return a personalized message.

  Try:Greet JohnTry:Say hello to Alice
• search

  Search for items by query.

  Try:Search for TypeScript tutorialsTry:Find articles about MCP servers
• template_echo_message

  Basic tool with format and auth options.

  Try:Echo back this messageTry:Show me a formatted response
• template_cat_fact

  Get external API call results with error handling.

  Try:Tell me a cat factTry:Get a random cat fact
• template_madlibs_elicitation

  Interactive tool that asks for user input.

  Try:Create a madlib with meTry:Help me make a fun story
• template_code_review_sampling

  Tool that uses LLM completion for code review.

  Try:Review this code for meTry:Analyze this function
• template_image_test

  Tool that handles image content blocks.

  Try:Create an image of a catTry:Show me a landscape image
• template_async_countdown

  Long-running task with progress reporting.

  Try:Start a 10 second countdownTry:Count down from 5 with updates
• template_data_explorer

  MCP Apps tool with linked UI resource.

  Try:Explore the dataTry:Show me the data explorer

Note: Extracted from example code snippets in the documentation showing actual tool implementations.

Comparable tools

Installation

bunx @cyanheads/mcp-ts-core init my-mcp-server
cd my-mcp-server
bun install

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "node",
      "args": ["dist/index.ts"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

FAQ

What platforms does this framework support?

The framework supports Bun, Node.js, and Cloudflare Workers, allowing deployment across various environments.

How does authentication work in the framework?

The framework supports authentication modes: 'none', 'jwt', or 'oauth' (with local secret or JWKS). Auth scopes can be defined on tools and resources.

Compare mcp-ts-core with