TypeScript MCP Demo Server

@gedankrayze

Repository

Basic information

About TypeScript MCP Demo Server

MCP Server Template for Bun Developers

#mcp #mcp-server

TypeScript MCP Demo Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ts-demo-mcp": {
      "command": "bun",
      "args": [
        "start"
      ]
    }
  }
}

TypeScript MCP Demo Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is TypeScript MCP Demo Server?

A basic Model Context Protocol (MCP) server implementation using the TypeScript SDK and Bun runtime. It demonstrates server initialization with stdio transport, tool registration, and TypeScript type safety, intended for developers learning to build MCP servers.

How to use TypeScript MCP Demo Server?

Clone the repository, install dependencies with bun install, then start the server using bun start or task start. For Claude Desktop integration, add the provided configuration to your Claude Desktop config. Optionally use task inspect-server for debugging via the MCP inspector.

Key features of TypeScript MCP Demo Server

Implementation with TypeScript SDK and Bun runtime
Stdio transport for server-client communication
Two example tools: greet and add_numbers
TypeScript strict mode for type safety
Integration with Claude Desktop via MCP protocol
MCP inspector support for debugging

Use cases of TypeScript MCP Demo Server

Learning how to build and structure an MCP server in TypeScript
Testing MCP tool registration and handling with a minimal demo
Integrating a custom MCP server with Claude Desktop for proof-of-concept
Exploring the MCP inspector for server capability debugging

Frequently asked questions

What runtime does TypeScript MCP Demo Server require?

It requires Bun (latest version). Task is optional for using the task runner.

What tools does the server provide?

Two tools: `greet` which takes a name string and returns a greeting, and `add_numbers` which takes two numbers and returns their sum.

How do I add new tools to the server?

Add a new tool definition in the `ListToolsRequestSchema` handler and implement its logic in the `CallToolRequestSchema` handler, following the provided example.

What transport does this server use?

It uses stdio transport, as specified in the server initialization and the Claude Desktop configuration example.

Where can I find the source code and documentation?

The project is hosted at https://github.com/gedankrayze/ts-demo-mcp. Additional MCP resources are linked in the README.

Comments

More Other MCP servers

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.