en es ja ko zh

MCP Server Boilerplate

Name: MCP Server Boilerplate
Author: cds-id

by cds-id

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

MCP サーバーボイラープレート

MCP TypeScript SDK NPM バージョン MITライセンス

TypeScript と Express を使用して構築された、モデルコンテキストプロトコル (MCP) の定型サーバー実装。

概要

このプロジェクトは、モデルコンテキストプロトコル（MCP）に準拠したサーバーを実装します。MCPにより、アプリケーションは標準化された方法でLLMのコンテキストを提供できるようになります。MCPには以下のものが含まれます。

HTTPおよびstdioトランスポートオプションを備えた完全に構成されたMCPサーバー
主要な機能を実証するためのサンプルリソース、ツール、プロンプト
型安全性と開発者エクスペリエンスの向上を実現する TypeScript サポート
HTTPトランスポート層の高速統合

プロジェクト構造

mcp-server-boilerplate/
├── .env                  # Environment variables
├── .env.example          # Example environment variables
├── .gitignore            # Git ignore file
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── src/
│   ├── index.ts          # Main HTTP server entry point
│   ├── stdio.ts          # Stdio server entry point
│   ├── resources/        # MCP resources
│   │   ├── index.ts      # Resource registration
│   │   ├── infoResource.ts # Static info resource
│   │   └── greetingResource.ts # Dynamic greeting resource
│   ├── tools/            # MCP tools
│   │   ├── index.ts      # Tool registration
│   │   ├── calculatorTool.ts # Sample calculator tool
│   │   └── timestampTool.ts # Sample timestamp tool
│   └── prompts/          # MCP prompts
│       ├── index.ts      # Prompt registration
│       ├── greetingPrompt.ts # Sample greeting prompt
│       └── analyzeDataPrompt.ts # Sample data analysis prompt
└── dist/                 # Compiled JavaScript output

はじめる

前提条件

Node.js (v18以降)
npmまたはyarn

インストール

リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/yourusername/mcp-server-boilerplate.git
cd mcp-server-boilerplate
npm install

環境変数

サンプル環境ファイルをコピーし、必要に応じて変更します。

cp .env.example .env

利用可能な環境変数:

PORT : HTTPサーバーのポート（デフォルト: 3000）
NODE_ENV : 環境モード（開発、本番）
OAuth設定（必要な場合）

サーバーの実行

HTTPサーバー

HTTP サーバーをビルドして起動します。

npm run build
npm start

自動再起動を使用した開発の場合:

npm run dev

サーバーはhttp://localhost:3000/mcp (または .env ファイルで指定されたポート) で利用できます。

標準モード

サーバーを stdio モード (コマンドラインツール用) で実行するには:

npm run start:stdio

自動再起動を使用した開発の場合:

npm run dev:stdio

リソース

定型文には次のサンプルリソースが含まれています。

静的情報リソース: info://server
- サーバーに関する基本情報を提供します
動的グリーティングリソース: greeting://{name}
- 指定された名前パラメータを使用してパーソナライズされた挨拶を生成します

リソースにアクセスするには:

MCPプロトコルを通じて
MCPクライアントライブラリの使用

ツール

定型文には次のサンプルツールが含まれています。

電卓: 基本的な算術演算を実行します
- パラメータ:
  - operation : 実行する演算（加算、減算、乗算、除算）
  - a : 最初の数字
  - b : 2番目の数字
タイムスタンプ: 現在の時刻をさまざまな形式で提供します
- パラメータ:
  - format : 出力形式 (iso、unix、readable)

プロンプト

定型文には次のサンプルプロンプトが含まれています。

挨拶: パーソナライズされた挨拶プロンプトを作成します
- パラメータ:
  - name : 挨拶する名前
  - formal ：フォーマルな挨拶スタイルを使用するかどうか（オプション）
データ分析: データ分析のプロンプトを作成します
- パラメータ:
  - data :分析するデータ
  - format : データ形式 (json、csv、テキスト)
  - instructions ：追加の分析指示（オプション）

サーバーの拡張

リソースの追加

新しいリソースを追加するには:

src/resources/に新しいファイルを作成します (例: myResource.ts )
リソースハンドラーを実装する
src/resources/index.tsに登録する

例：

// myResource.ts
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';

export function myResource(server: McpServer): void {
  server.resource('my-resource', 'my-resource://path', async uri => ({
    contents: [
      {
        uri: uri.href,
        text: 'My resource content',
      },
    ],
  }));
}

// Then add to resources/index.ts
import { myResource } from './myResource.js';

export function registerResources(server: McpServer): void {
  // ...existing resources
  myResource(server);
}

ツールの追加

新しいツールを追加するには:

src/tools/に新しいファイルを作成します (例: myTool.ts )
ツールハンドラーを実装する
src/tools/index.tsに登録する

例：

// myTool.ts
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { z } from 'zod';

export function myTool(server: McpServer): void {
  server.tool('my-tool', { param: z.string() }, async ({ param }) => ({
    content: [
      {
        type: 'text',
        text: `Processed: ${param}`,
      },
    ],
  }));
}

// Then add to tools/index.ts
import { myTool } from './myTool.js';

export function registerTools(server: McpServer): void {
  // ...existing tools
  myTool(server);
}

プロンプトの追加

新しいプロンプトを追加するには:

src/prompts/に新しいファイルを作成します（例： myPrompt.ts ）
プロンプトハンドラーを実装する
src/prompts/index.tsに登録する

例：

// myPrompt.ts
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { z } from 'zod';

export function myPrompt(server: McpServer): void {
  server.prompt('my-prompt', { topic: z.string() }, ({ topic }) => ({
    messages: [
      {
        role: 'user',
        content: {
          type: 'text',
          text: `Please explain ${topic} in simple terms.`,
        },
      },
    ],
  }));
}

// Then add to prompts/index.ts
import { myPrompt } from './myPrompt.js';

export function registerPrompts(server: McpServer): void {
  // ...existing prompts
  myPrompt(server);
}

テストとデバッグ

MCP サーバーをテストするには、以下を使用できます。

MCPインスペクターツール
MCP クライアントライブラリ
直接 HTTP リクエスト (デバッグ用)

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

Available Tools

2 tools

calculateD

ParametersJSON Schema

Name	Required	Description	Default
`operation`	Yes
`a`	Yes
`b`	Yes

TDQS

D1/5.0

Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

timestampD

ParametersJSON Schema

Name	Required	Description	Default
`format`	No		iso

TDQS

D1/5.0

Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

2 tool updatesAug 15, 2025
- First observedcalculate
- First observedtimestamp

Deploy Server

Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

TDQS

D1.7/5.0

Scored 2026-04-18 10:15 across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: 'calculate' suggests mathematical or computational operations, while 'timestamp' implies time-related functions. With no overlapping descriptions, there is no ambiguity between them.

Naming Consistency5/5

Both tool names follow a consistent pattern of using single, descriptive nouns in lowercase. There are no deviations in style or convention across the set.

Tool Count2/5

With only 2 tools, the server feels thin and under-scoped for a 'boilerplate' purpose, which typically implies a foundational or example set. This minimal count limits functionality and utility.

Completeness1/5

The server lacks descriptions, making it impossible to infer a clear domain or assess coverage. Without context, it appears severely incomplete, with no indication of what operations are supported or how they fit together.

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

hithereiamaliff-mcp-nextcloudOAuth
ai.smithery
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Cloud Storage File Systems Workplace & Productivity
238
Apideck MCP A
dev.apideck.mcp
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Developer Tools
42
Mercado PagoOAuth
com.mercadopago.mcp
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Finance E-commerce & Retail App Automation
2
jumpcloud-genaiOAuth
com.jumpcloud
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Cloud Platforms Security Developer Tools
2

Related MCP Servers

MCP Server Sample
Developer Tools Code Execution Autonomous Agents
antonscap
A
license
B
quality
D
maintenance
An educational implementation of a Model Context Protocol server that demonstrates how to build a functional MCP server integrating with various LLM clients.
Updated a year ago (2025-05-16 10:16 UTC)
2
MIT
MCP Server Scaffold
vjouenne76
F
license
B
quality
D
maintenance
A basic starter project for building Model Context Protocol (MCP) servers that enables standardized interactions between AI systems and various data sources through secure, controlled tool implementations.
Updated a year ago (2025-07-09 01:53 UTC)
2
-
TypeScript MCP Server
Developer Tools Code Execution
chuljung
F
license
Not graded
quality
D
maintenance
A starter project designed to quickly build and deploy Model Context Protocol (MCP) servers using the TypeScript SDK and Zod for schema validation. It features example implementations for tools and resources, providing a solid foundation for custom MCP development and integration.
Updated 10 months ago (2025-12-15 08:24 UTC)
-
Basic MCP Server
Developer Tools
Habib0x0
F
license
Not graded
quality
D
maintenance
A minimal Model Context Protocol (MCP) server demonstrating the implementation of tools, resources, and prompts. It serves as a starter template built with the Smithery SDK for developing custom integrations.
Updated 7 months ago (2026-03-26 00:42 UTC)
-

MCP サーバー ボイラープレート

目次

概要

プロジェクト構造

はじめる

前提条件

インストール

環境変数

サーバーの実行

HTTPサーバー

標準モード

リソース

ツール

プロンプト

サーバーの拡張

リソースの追加

ツールの追加

プロンプトの追加

テストとデバッグ

ライセンス

Available Tools

TDQS

TDQS

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

MCP Server Sample

MCP Server Scaffold

TypeScript MCP Server

Basic MCP Server

MCP サーバーボイラープレート