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.