MCP.so
Sign In

MCP Server Boilerplate

@takunagai

Repository

About MCP Server Boilerplate

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

#mcp#server#boilerplate

Basic information

Category

Developer Tools

Runtime

node

Transports

stdio

Publisher

takunagai

Config

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

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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

FAQ from MCP Server Boilerplate

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

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

Security scanner for AI agents, MCP servers and agent skills.

2.8K

Huoshan Test

volcengine

2.4K

Burp Suite MCP Server Extension

PortSwigger

MCP Server for Burp

961

Test

x1xhlol

FULL Augment Code, Claude Code, Cluely, CodeBuddy, Comet, Cursor, Devin AI, Junie, Kiro, Leap.new, Lovable, Manus, NotionAI, Orchids.app, Perplexity, Poke, Qoder, Replit, Same.dev, Trae, Traycer AI, VSCode Agent, Warp.dev, Windsurf, Xcode, Z.ai Code, Dia & v0. (And other Open Sou

141.7K

MCP Unity Editor (Game Engine)

CoderGamester

Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs

1.8K