boilerplate-mcp-server

TypeScript Model Context Protocol (MCP) server boilerplate providing IP lookup tools/resources. Includes CLI support and extensible structure for connecting AI systems (LLMs) to external data sources like ip-api.com. Ideal template for creating new MCP integrations via Node.js.

boilerplatetypescripttoolsaiservertoolingmcpresourcesclaudellmanthropicai-integration
FreeRepo

Preview

boilerplate-mcp-server preview

Overview

This is a production-ready TypeScript foundation for building Model Context Protocol (MCP) servers that connect AI assistants to external APIs and data sources. It provides a five-layer architecture pattern, dual transport support (STDIO and HTTP), complete type safety with Zod validation, comprehensive testing infrastructure and a working IP geolocation example to demonstrate implementation patterns.

Features

dual-transport-supportstdio-transporthttp-transportlayered-architecturetype-safetyzod-validationip-geolocationerror-handlingcontextual-loggingmcp-inspector-integrationcli-commandsapi-integrationextensible-structure

Feature Flags

authenticationauthorizationaiapiDocsformsValidationerrorTrackinglogging

Recommended Use Cases

ai-assistant-integrationllm-tool-developmentexternal-api-connectionmcp-server-creationclaude-desktop-integrationcursor-ai-integration

Frontend

None

Backend

node.jstypescript

Auth Providers

None

Deployment Targets

node.jslocalhttp-server

Payment Providers

None

Quick Facts

โญ Stars
60
๐Ÿด Forks
20
๐Ÿ”„ Active
Yes
๐Ÿ•’ Last Commit
2025-09-09T05:58:12Z

Stack

Language
typescript
Testing
jest
CI
semantic-release

Data Layer

UI Stack

Developer Experience

Docker
No
Tests
Yes
Quickstart
Yes
env.example
Yes
CI
semantic-release

Pricing

Classification
free
Selected
โ€”
Notes
Open source boilerplate template
Get Started with this Boilerplate