bladnman/mcp-server-template
If you are the rightful owner of mcp-server-template and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A starting point for an MCP Server template that can be customized and extended.
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 greetingwelcome://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
