Skip to main content
Glama
MCP Server Template

MCP Server Template

MCP Server Template

A template for building a Model Context Protocol (MCP) server using TypeScript.

Features

  • TypeScript configuration (Node16 / ESModules).

  • Type-safe argument validation using Zod.

  • Standard I/O (stdio) transport setup.

  • Example echo tool included.

Related MCP server: TypeScript MCP Server Boilerplate

Prerequisites

  • Node.js

  • npm or your preferred package manager

Installation

Install the required dependencies:

npm install

Build

Compile the TypeScript source code into the build/ directory:

npm run build

Running the Server

Start the compiled server:

npm start

Because the server uses standard I/O (stdio) for transport, it will wait for an MCP client to connect and communicate via stdin and stdout.

Project Structure

  • src/index.ts: Application entry point setting up the standard I/O transport.

  • src/server.ts: Initializes the MCP server instance and registers its handlers.

  • src/handlers/tool.ts: Registers tool request handlers with the MCP server.

  • src/tools/example.ts: Contains the domain logic, input schema, and execution logic for individual tools.

  • tsconfig.json: TypeScript compiler configuration.

  • package.json: Project metadata and scripts.

Adding New Tools

To add a new tool to your MCP server:

  1. Create a new file in src/tools/ defining your tool's input schema (via Zod), definition metadata, and execution logic handler function.

  2. Open src/handlers/tool.ts and add your new tool's definition to the array returned by the ListToolsRequestSchema handler.

  3. Add a new case in the CallToolRequestSchema handler inside src/handlers/tool.ts to call your new tool's execution function.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A template repository for building Model Context Protocol (MCP) servers with TypeScript, featuring full TypeScript support, testing setup, CI/CD pipelines, and modular architecture for easy extension.
      Creative Commons Attribution Non Commercial Share Alike 4.0 International
    • A
      license
      Not graded
      quality
      D
      maintenance
      A starter template for building Model Context Protocol (MCP) servers using TypeScript and Zod for schema validation. It provides a foundational structure and examples for implementing custom tools and resources, such as calculators and system information endpoints.
      ISC
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server template designed for building structured tools, prompts, and resources with built-in support for HTTP and STDIO transports. It provides a standardized framework for developers to create and deploy AI-driven services using TypeScript and Zod schema validation.
      -