MCP Catalogs
Home

template-mcp-server

by mcpdotdirect·74·Score 45

A starter template for building MCP servers with FastMCP supporting both stdio and HTTP transports.

developer-toolsproductivityother
39
Forks
2
Open issues
6 mo ago
Last commit
2d ago
Indexed

Overview

This repository provides a well-structured template for developers looking to create their own MCP (Model Context Protocol) servers. It includes support for both stdio and HTTP transport methods, making it suitable for both personal development and team collaboration scenarios. The template is built using FastMCP and offers TypeScript support for type safety, along with clear examples for adding custom tools, resources, and prompts to extend server functionality.

Try asking AI

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

you:Quickly bootstrap new MCP server projects with minimal setup
you:Create team-shared MCP tools using HTTP transport
you:Develop personal productivity tools with stdio transport
you:What transport methods are supported?
you:How do I run the server in development mode?

When to choose this

Choose this template if you're a TypeScript developer looking to quickly scaffold a new MCP server with both stdio and HTTP transport options.

When NOT to choose this

Don't choose this if you need server-side authentication, as the template doesn't include an authentication model.

Tools this server exposes

1 tool extracted from the README (low confidence)
  • hello_worldname: string

    A simple hello world tool that greets a given name

Note: Inferred from example code snippet showing how to add tools to a FastMCP server, not from actual tool documentation

Comparable tools

fastmcpmcp-server-templatemcp-template-typescriptcreate-mcp-server

Installation

Installation

Create a new MCP server project using npx or npm:

# with npx
npx @mcpdotdirect/create-mcp-server

# Or with npm
npm init @mcpdotdirect/mcp-server

After creating your project, install dependencies:

npm install

Claude Desktop Configuration

Add to your Claude Desktop config.json:

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "npm",
      "args": ["start"]
    }
  }
}

FAQ

What transport methods are supported?
The template supports both stdio (CLI mode) and HTTP (SSE mode) transport methods. Stdio is ideal for personal development, while HTTP can be shared across machines for team collaboration.
How do I run the server in development mode?
Use the npm scripts: `npm run dev` for stdio transport or `npm run dev:http` for HTTP transport. Both modes provide auto-reloading for development.

Compare template-mcp-server with

GitHub →

Last updated · Auto-generated from public README + GitHub signals.