MCP Server Boilerplate

@takunagai

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

takunagai

关于 MCP Server Boilerplate

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

#mcp #server #boilerplate

MCP Server Boilerplate 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

MCP Server Boilerplate 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

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

常见问题

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 服务器

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.

screenshotrun-mcp

screenshotrun

Give your AI agent the ability to see any webpage. Capture screenshots from Claude, Cursor, or any MCP client. Supports full-page, dark mode, mobile emulation, OG image generation, base64 output, custom viewport, ad bloc

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

Foremerge

naw103

Catch intent conflicts before code conflicts. The open-source coordination protocol for coding agents, built above Git.

Cronwatch

cronwatchdev

CronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.