node-mcp-template

A quick start TypeScript template for building an MCP server with Node.

This template currently includes one example tool:

• add_two_numbers - adds two numbers and returns the result as text content.

Built on top of the instructions provided here, but includes goodies like Vitest, Prettier, ESLint.

• Node.js 24

npm install

• npm run dev - run the MCP server directly from TypeScript with tsx
• npm run build - compile TypeScript to dist/
• npm run test - run unit tests with Vitest
• npm run lint - run ESLint
• npm run open-config - open/create Claude Desktop config file

For local development:

npm run dev

For compiled output:

npm run build
node ./dist/index.js

Open your Claude config:

npm run open-config

Then add an MCP server entry (update paths for your machine):

{
  "mcpServers": {
	"add_two_numbers": {
	  "command": "node",
	  "args": ["/PATH/TO/PROJECT/dist/index.js"]
	}
  }
}

Build before launching Claude when using the dist entry above.

npm run test