MCP Server Boilerplate

Name: MCP Server Boilerplate
Author: takunagai

@takunagai

リポジトリ

MCP Server Boilerplate について

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

#mcp #server #boilerplate

基本情報

カテゴリ

開発者ツール

ランタイム

node

トランスポート

stdio

公開者

takunagai

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.

「開発者ツール」の他のコンテンツ

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K

Code Index MCP

johnhuang316

A Model Context Protocol (MCP) server that helps large language models index, search, and analyze code repositories with minimal setup

979

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K