TypeScript MCP Demo Server

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

FAQ from TypeScript MCP Demo Server

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.