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

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 ファイルを参照してください。

MCP Server Boilerplate

Integrations