boilerplate-mcp-server

Overview

A comprehensive TypeScript boilerplate for creating MCP servers with a clean layered architecture. It provides security-first design with DNS rebinding protection, dual transport support (STDIO and HTTP), and optimized token output formats like TOON. The server includes a complete IP geolocation example with ip-api.com integration, testing infrastructure, and production tooling.

Try asking AI

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

• ip_get_details

  Get detailed information about an IP address including location, ISP, and other geolocation data

  Try:Get details for IP address 8.8.8.8Try:What can you tell me about my current IP?Try:Find information for IP 1.1.1.1 with extended data
• ip_get_details_link

  Get IP details using the ResourceLink pattern for token-efficient responses

  Try:Get details for IP 192.168.1.1 with resource linkingTry:Retrieve information about IP 10.0.0.1 using the link pattern

Comparable tools

Installation

# Clone the repository
git clone https://github.com/aashari/boilerplate-mcp-server.git
cd boilerplate-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Run in STDIO mode for Claude Desktop
npm run mcp:stdio

{
  "mcpServers": {
    "boilerplate-mcp": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "TRANSPORT_MODE": "stdio"
      }
    }
  }
}

FAQ

What transport modes does this server support?

The server supports both STDIO transport (for Claude Desktop, Cursor) and HTTP transport (for web integrations) with automatic fallback.

How is security handled in this implementation?

The server implements DNS rebinding protection, localhost-only binding, secure error handling, and provides comprehensive authentication guides for production deployment.

Compare boilerplate-mcp-server with