Boilerplate MCP Server

What is Boilerplate MCP Server?

Boilerplate MCP Server is a production-ready foundation for developing custom Model Context Protocol (MCP) servers in TypeScript. It provides a complete layered architecture pattern, working example implementation, and comprehensive developer infrastructure to connect AI assistants with external APIs and data sources.

How to use Boilerplate MCP Server?

Clone the repository, install dependencies, and build the project. Run in CLI mode (npm run cli -- get-ip-details), STDIO transport (npm run mcp:stdio), HTTP transport (npm run mcp:http), or development with MCP Inspector (npm run mcp:inspect). Transport mode is configured via the TRANSPORT_MODE environment variable.

Key features of Boilerplate MCP Server

• Security First: DNS rebinding protection and localhost-only binding
• Dual Transport Support: STDIO and Streamable HTTP with automatic fallback
• Layered Architecture: Six clean layers for maintainable code
• Type Safety: Full TypeScript with Zod v4.3.6 schema validation
• All MCP Primitives: Tools, resources, and prompts with examples
• TOON Output Format: 30–60% fewer tokens than JSON

Use cases of Boilerplate MCP Server

• Build custom MCP servers for any external API or data source
• Develop and test AI assistant tools using the included IP geolocation example
• Integrate with Claude Desktop or Cursor AI via STDIO transport
• Rapidly prototype with MCP Inspector’s debugging UI
• Serve multiple concurrent connections via HTTP transport