Skip to main content
Glama

MCP TypeScript Template

by jerkovicl
GitHub
TypeScript
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP TypeScript Template

A TypeScript template for building remote Model Context Protocol (MCP) servers with modern tooling and best practices while leveraging the MCP TypeScript SDK.

Features

This template provides:

  • TypeScript - Full TypeScript support with strict configuration

  • Vite - Fast build system with ES modules output

  • Express - Fast, unopinionated web framework for HTTP server

  • ESLint + Prettier - Code quality and formatting

  • Docker - Containerization support

  • Example Tool - Simple echo tool to demonstrate MCP tool implementation

Getting Started

  1. Clone or use this template

    git clone <your-repo-url> cd mcp-typescript-template

  2. Install dependencies

    npm install

  3. Build the project

    npm run build

  4. Start the server

    npm start

The server will be available at http://localhost:3000 for MCP connections.

Development

Watch mode for development (with hot reloading)

npm run dev

Build the project

npm run build

Linting

  • Lint the project

npm run lint

  • Fix all auto-fixable lint errors

npm run lint:fix

Formatting

  • Format files in the project

npm run format

  • Check formatting

npm run format:check

Available Tools

The template includes one example tool:

echo

Echoes back the provided message - a simple example to demonstrate MCP tool implementation.

Parameters:

  • message (string) - The message to echo back

Customizing Your MCP Server

  1. Update package.json - Change name, description, and keywords

  2. Modify src/index.ts - Replace the echo tool with your custom tools

  3. Add your logic - Create additional TypeScript files for your business logic

  4. Update README - Document your specific MCP server functionality

Docker

Build and run using Docker:

  • Build the Docker image

docker build -t my-mcp-server .

  • Run the container

docker run -p 3000:3000 my-mcp-server

Docker Compose

# docker-compose.yml version: "3.8" services: mcp-server: build: . ports: - "3000:3000" environment: - PORT=3000
docker-compose up --build

Project Structure

mcp-typescript-template/ ├── src/ │ └── index.ts # Main MCP server entry point ├── dist/ # Built output (generated) ├── .eslintrc.js # ESLint configuration ├── .prettierrc # Prettier configuration ├── tsconfig.json # TypeScript configuration ├── vite.config.ts # Vite build configuration ├── Dockerfile # Docker configuration └── package.json # Dependencies and scripts

Architecture

This template follows a simple architecture:

  • HTTP Transport - Uses Express with StreamableHTTPServerTransport for remote MCP connections

  • Tool Registration - Tools are registered with JSON schemas for input validation

  • Error Handling - Proper MCP-formatted error responses

  • Session Management - Handles MCP session initialization and management

Example: Adding a New Tool

import { createTextResult } from "./lib/utils.js"; server.registerTool( "my_tool", { title: "My Custom Tool", description: "Description of what this tool does", inputSchema: { param1: z.string().describe("Description of param1"), param2: z.number().optional().describe("Optional parameter"), }, }, async (args) => { // Your tool logic here const result = await myCustomLogic(args.param1, args.param2); return createTextResult(result); }, );

Why Express?

This template uses Express for the HTTP server, which provides:

  • MCP SDK Compatibility - Full compatibility with the MCP TypeScript SDK's StreamableHTTPServerTransport

  • Mature & Stable - Battle-tested HTTP server with extensive ecosystem

  • TypeScript Support - Excellent TypeScript support with comprehensive type definitions

  • Middleware Ecosystem - Rich ecosystem of middleware for common tasks

  • Documentation - Comprehensive documentation and community support

  • Reliability - Proven reliability for production applications

Repository Guidelines

Contributors should review AGENTS.md for project structure, coding standards, and pull request expectations before opening changes.

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A TypeScript template for building remote Model Context Protocol (MCP) servers with modern tooling including Vite, Express, and Docker support. Provides a foundation with an example echo tool to help developers quickly create custom MCP servers.

  1. Features
    1. Getting Started
      1. Development
        1. Watch mode for development (with hot reloading)
        2. Build the project
        3. Linting
        4. Formatting
      2. Available Tools
        1. echo
      3. Customizing Your MCP Server
        1. Docker
          1. Docker Compose
        2. Project Structure
          1. Architecture
            1. Example: Adding a New Tool
              1. Why Express?
                1. Repository Guidelines

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/jerkovicl/flights-mcp'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server