Template

You run an MCP server using a lightweight TypeScript template that wires an HTTP transport via Express and provides a simple example tool to demonstrate how MCP endpoints work. This server lets you connect clients, register tools, validate inputs, and exchange MCP messages in a structured way.

How to use

You connect with an MCP client to the server at the HTTP endpoint and use the built-in tool framework to expose your own functionality. The example tool demonstrates how to validate inputs, run business logic, and return results in MCP-compliant responses. Start the server, then connect your MCP client to interact with the registered tools, test tool inputs, and observe request and response flows.

How to install

Prerequisites you need before installing: Node.js (recommended LTS version) and npm. Optionally, you can use npx for quick template usage.

Step 1: Create a new project from the template using npx degit.

npx degit nickytonline/mcp-typescript-template my-mcp-server
cd my-mcp-server

Step 2: Install dependencies.

npm install

Step 3: Build the project.

npm run build

Step 4: Start the server.

npm start

Additional setup and run patterns

If you prefer cloning from a template, you can clone a GitHub template and then install dependencies.

git clone <your-repo-url>
cd my-mcp-server
npm install

Available tools

echo

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