Template for MCP Server

A starting point for an MCP Server.

DUPLICATE ME

The whole idea here is for you to take this for your own. Running this to create a new folder with your own copy of this template (git removed and replaced with a new one).

replace mcp-server with name of your choice:

npx make-mine https://github.com/bladnman/mcp-server-template.git <mcp-server>

Features

• Simple string reversal tool
• Support for both stdio and SSE transports
• TypeScript implementation with full build process

Tools

reverse

Takes a string input and returns it reversed.

Example:

• Input: "hello world"
• Output: "dlrow olleh"

Resources

• greeting://hello: A welcome greeting
• welcome://info: Information about the server and its capabilities

Getting Started

Testing with MCP Inspector

There's a way to test the server itself using a generic inspector tool which allows you to see the transiting message between the server and the client. It is dropping to shell and running this command.

npx fastmcp inspect server.ts

And then going to the url it provides (likely): http://localhost:5173

and for the current server that we're running here this server we will want to execute the run server.sh file that you see in the root directory as stdio with no arguments.

<full_path_to_server>/run-server.sh

Prerequisites

• Node.js (v14 or higher)
• npm

Installation

# Install dependencies
npm install

Running the Server

# Build and run with stdio transport (default)
bash run-server.sh

# Or, to run with SSE transport
TRANSPORT_TYPE=sse npm run start

By default, the SSE server runs on port 4000. Change in the CONST.ts file.

Development

# Run in development mode with hot reloading
npm run dev

# Watch for changes and rebuild automatically
npm run watch

Building

# Build TypeScript to JavaScript
npm run build

The built files will be in the dist directory.

License

ISC License