node-mcp-server by my-mcp-hub - MCP Server

Node.js MCP Server Template

A Model Context Protocol (MCP) server template for Node.js applications. This template provides a foundation for building MCP-compatible servers with support for multiple transport protocols.

Features

Multiple Transport Protocols :
- Standard I/O (stdio) for command-line interfaces
- HTTP Streamable transport for web applications
- Server-Sent Events (SSE) for real-time updates
TypeScript Support : Built with TypeScript for type safety and better developer experience
Development Tools :
- Hot reloading during development
- Integration with MCP Inspector for debugging
- ESLint and Prettier for code quality
- Husky and lint-staged for Git hooks
Extensible Tool System : Easy registration of custom MCP tools

Prerequisites

Node.js (latest LTS version recommended)
npm or yarn

Installation

npm install

Development

# Start development server with stdio transport
npm run dev

# Start development server with web transport
npm run dev:web

When using dev:web , the server will be available at:

Streamable HTTP endpoint: http://localhost:8401/mcp
SSE endpoint: http://localhost:8401/sse

Building

npm run build

The build output will be in the build directory.

Usage

Command Line

# Start with stdio transport (default)
node build/index.js

# Start with web transport
node build/index.js web --port 8401

Adding Custom Tools

Custom tools can be added in the src/tools/index.ts file:

server.registerTool(
  'YourToolName',
  {
    title: 'Your Tool Name',
    description: 'Tool description',
    inputSchema: {
      param1: z.string().describe('Parameter description'),
    },
  },
  ({ param1 }) => {
    // Implement tool logic
    return {
      content: [
        {
          type: 'text',
          text: `Your tool response: ${param1}`,
        },
      ],
    }
  },
)

Environment Variables

PORT : Specify the port for web transport (default: 8401)
NODE_ENV : Set to production for production builds or local for development

my-mcp-hub/node-mcp-server