
MCP Server Boilerplate
by aashari
Production-ready TypeScript template for building MCP servers with dual transport and layered architecture.
What it does
This is a comprehensive foundation for developers to build custom Model Context Protocol (MCP) servers. It provides a professional layered architecture that separates CLI, tool definitions, business logic (controllers), and external API integrations (services), ensuring type safety and maintainability.
Tools
- IP Geolocation: Example tools for looking up IP details using ip-api.com.
- Resource Linking: Implements the ResourceLink pattern to provide efficient references to large data sets.
- JMESPath Filtering: Allows AI assistants to extract specific fields from API responses to save tokens.
- TOON Formatting: Uses Token-Oriented Object Notation to reduce token consumption by 30-60%.
Installation
Clone and build the project, then add to claude_desktop_config.json:
{
"mcpServers": {
"mcp-boilerplate": {
"command": "node",
"args": ["/path/to/boilerplate-mcp-server/dist/index.js"],
"env": { "TRANSPORT_MODE": "stdio" }
}
}
}
Supported hosts
- Claude Desktop
- Cursor
Quick install
npm install @aashari/boilerplate-mcp-serverInformation
- Pricing
- free
- Published
- 4/19/2026
- stars






