Developer Tools · AI Chatbot

Boilerplate MCP Server logo

Boilerplate MCP Server

aashari/boilerplate-mcp-server

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

Install

Environment variables

IPAPI_API_TOKEN
GitHub stars
13
Author
@aashari
Category
Developer Tools, AI Chatbot
License
ISC
Updated
Oct 6, 2026

About Boilerplate MCP Server

Latest Update (Feb 2026): Updated to MCP SDK 1.26.0 and Zod 4.3.6 with continued modern registerTool patterns and streamable HTTP improvements. See docs/MODERNIZATION.md for details.

Features

  • Security First: DNS rebinding protection, localhost-only binding, secure error handling

  • Dual Transport Support: STDIO and Streamable HTTP transports with automatic fallback

  • Layered Architecture: Clean separation between CLI, tools, resources, prompts, controllers, services, and utilities

  • Type Safety: Full TypeScript implementation with Zod v4.3.6 schema validation

  • All MCP Primitives: Tools, resources, and prompts (with examples)

  • ResourceLink Pattern: Token-efficient resource references for large responses

  • TOON Output Format: Token-Oriented Object Notation for 30-60% fewer tokens than JSON

  • JMESPath Filtering: Extract only needed fields from responses to reduce token costs

  • Raw Response Logging: Automatic logging of large API responses to /tmp/mcp/<project>/ with truncation guidance

  • Modern SDK: Uses MCP SDK v1.26.0 with registerTool API pattern (ready for v2 migration)

Tools (6)

  • Purpose

    MCP tool definitions that AI assistants can invoke

  • Implementation

    Zod schema validation with structured responses

  • Example

    ip_get_details tool with optional IP address and configuration options

  • Pattern

    Define schema → Validate args → Call controller → Format MCP response

  • ip_get_details

    IP geolocation lookup for AI assistants

  • ip_get_details_link

    Same lookup + resource link output for resource-aware clients

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
Cursor logo

Cursor

Desktop · Freemium · Proprietary

The first agentic IDE. The Cursor editor truly merges how developers and AI work together, delivering a magical coding experience.

WindowsMacOSLinux

Related MCP servers

More servers
Playwright logo

Playwright

microsoft/playwright

72.2k

Playwright is a framework for web automation and testing. It drives Chromium, Firefox, and WebKit with a single API — in your tests, in your scripts, and as a tool for AI agents.

Developer Tools
repomix logo

repomix

yamadashy/repomix

15.2k

Repomix is a tool that packs a codebase into an AI-friendly format, supporting local and remote repository processing and providing code compression, security checks and multiple output formats.

Developer Tools
UI-TARS-desktop logo

UI-TARS-desktop

bytedance/UI-TARS-desktop

12.9k

TARS is ByteDance's multimodal AI agent stack, shipping two projects: Agent TARS (a CLI and Web UI agent built on MCP) and UI-TARS-desktop (a desktop GUI agent).

Developer Tools
blender logo

blender

ahujasid/blender-mcp

10.6k

formerly blender-mcp — the PyPI package is now mcp-for-blender. Existing setups keep working; no config change is required. Read more.

Developer Tools
Playwright Browser Automation logo

Playwright Browser Automation

microsoft/playwright-mcp

9.2k

A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright. This server enables LLMs to interact with web pages through structured accessibility snapshots, bypassing the need for screenshots or visually-tuned models.

Developer Tools
2344 logo

2344

comet-ml/opik

7k

Opik is the open-source LLM observability and evaluation platform for AI agent tracing, LLM evaluation, prompt management, and production monitoring. Built by Comet. Apache-2.0 licensed, free to self-host the full platform, with 20,000+ GitHub stars.

Developer Tools