MCP Server Boilerplate

@takunagai

Repository

Basic information

About MCP Server Boilerplate

Model Context Protocol(MCP) サーバーのボイラープレートとなるシンプルな実装です。

#mcp #server #boilerplate

MCP Server Boilerplate config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-boilerplate-takunagai": {
      "command": "npx",
      "args": [
        "serve",
        "dummy-server"
      ]
    }
  }
}

MCP Server Boilerplate tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is MCP Server Boilerplate?

MCP Server Boilerplate is a minimal reference implementation of a Model Context Protocol (MCP) server. It provides a starting point for developers to quickly build custom MCP servers and add their own tools, with examples demonstrating implementation patterns.

How to use MCP Server Boilerplate?

Clone the repository, run npm install and npm build, then add the server configuration to your MCP client's settings file using the absolute path to build/index.js. Optionally set environment variables under the "env" key, and start the dummy server with npx serve dummy-server. Restart the MCP client and run one of the provided prompt examples to verify the tools work.

Key features of MCP Server Boilerplate

Two sample tools: double_number and get_test_text
Demonstrates custom tool creation using the MCP SDK
Includes a dummy data server for testing
Multiple version branches showing progressive features
Uses Biomes for linting and formatting

Use cases of MCP Server Boilerplate

Learning how to build and extend an MCP server
Rapidly prototyping custom MCP tools
Testing MCP client integration with a simple server

Frequently asked questions

What tools does the boilerplate include?

It includes `double_number` (doubles a given number) and `get_test_text` (fetches a string from the dummy server and displays the environment variable FOO).

How do I add a new custom tool?

Edit `src/index.ts` and follow the documented pattern: define the tool name, description, parameter schema with Zod, and a handler returning a `CallToolResult`.

What are the runtime requirements?

Node.js v23.11.0 or later, plus npm or yarn.

How do I set environment variables for the server?

Add an `"env"` object in the MCP client configuration file under the server entry, e.g., `"env": { "FOO": "BAR" }`.

Which MCP clients are supported?

Claude Code, VSCode, Windsurf, and Cursor are listed; AWS Bedrock is mentioned as untested.

Comments

More Developer Tools MCP servers

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

TranscriptFetch MCP Server

TranscriptFetch

Model Context Protocol (MCP) server for TranscriptFetch: fetch YouTube transcripts, search, channels, and playlists from any MCP client.

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

OrangePro

Aamir Siddiqui

OrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up