mcp-server-tamplate

Overview

This is a well-structured TypeScript template for creating MCP servers using the official SDK. It provides a clean architecture with separated concerns for tools, adapters, and core protocols. The template includes an example health check tool and demonstrates proper tool registration patterns. It follows MCP protocol requirements by avoiding console.log in favor of console.error for logging.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• health

  Health check tool to verify server status

  Try:Check server healthTry:Is the server running?

Comparable tools

Installation

# Clone the repository
git clone https://github.com/gustta03/mcp-server-template.git

cd mcp-server-template

# Install dependencies
npm install

# Build the server
npm run build

# Run the server
npm start

{
  "mcpServers": {
    "mcp-server-template": {
      "command": "node",
      "args": ["/absolute/path/to/your/mcp-server-template/build/main.js"]
    }
  }
}

FAQ

How do I add a new tool to my MCP server?

Create a new class implementing the McpTool interface in the src/tools directory, then register it in main.ts by importing and adding it to the registerMcpTools function call.

Why is there no console.log in the template?

The stdout channel is reserved for the MCP protocol. Always use console.error for logging to avoid interfering with protocol communication.

Compare mcp-server-tamplate with