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
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
GitHub
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