MCP Server

MCP サーバー

stdio（標準入力／出力）と SSE（サーバー送信イベント）の両方のトランスポートに対応した、Model Context Protocol（MCP）サーバーを作成するための TypeScript テンプレートリポジトリです。このテンプレートは、整理された構成と基本的な機能を備えた、MCP サーバー構築のための確かな基盤を提供します。

機能

• 🚀 型安全性と優れた開発者エクスペリエンスを実現する TypeScript 製
• 🔄 stdio と SSE の両方のトランスポートに対応
• 📦 プロンプト、リソース、ツールのサンプルを収録
• ⚡ 迅速な開発のために FastMCP を使用

前提条件

• Node.js
• npm または yarn パッケージマネージャー

はじめに

1. このテンプレートからリポジトリを作成する

   Use this template > Create a new repository をクリックします

   

2. リポジトリをクローンする

   git clone https://github.com/iamtraction/node-mcp-server.git
   cd node-mcp-server
   

3. 依存関係をインストールする

   npm install
   

4. 開発サーバーを起動する

   npm run dev
   

プロジェクト構成

src/
├── prompts/     # MCP prompts
├── resources/   # MCP resources
├── tools/       # MCP tools
└── server.ts    # Main server file

利用可能なスクリプト

• npm run dev - ホットリロードで開発サーバーを起動
• npm run build - TypeScript コードをビルド
• npm run start - 本番サーバーを起動
• npm run watch - TypeScript の変更を監視
• npm run lint - ESLint でコードの品質とスタイルをチェック

新機能の追加

プロンプトの追加

src/prompts/ に新しいファイルを作成し、server.ts に追加します。MCP プロンプトの詳細をご覧ください。

import myPrompt from "./prompts/my-prompt.js";
server.addPrompt(myPrompt);

リソースの追加

src/resources/ に新しいファイルを作成し、server.ts に追加します。MCP リソースの詳細をご覧ください。

import myResource from "./resources/my-resource.js";
server.addResource(myResource);

ツールの追加

src/tools/ に新しいファイルを作成し、server.ts に追加します。MCP ツールの詳細をご覧ください。

import myTool from "./tools/my-tool.js";
server.addTool(myTool);

設定

サーバーは server.ts で設定できます。デフォルトでは、SSE トランスポートを使用してポート 3000 で実行されます。server.start() のオプションで設定を変更できます。

server.start({
    transportType: "httpStream", // or "stdio"
    httpStream: {
        port: 3000,
    },
});

トランスポートの詳細をご覧ください。

MCP サーバーの使用方法

stdio サーバーのセットアップ

{
    "mcpServers": {
        "example-server": {
            "command": "node",
            "args": [ "dist/server.js" ]
         }
    }
}

SSE サーバーのセットアップ

{
    "mcpServers": {
        "example-server": {
            "url": "https://example-server.com/sse"
         }
    }
}

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

ショーケース

このテンプレートを使って何かすばらしいものを作りましたか？ショーケースに追加してください！

プロジェクトをショーケースに追加するには：

1. この README.md ファイルを編集します
2. 次の形式で、上記のリストにプロジェクトを追加します：

   - [Your Project Name](link-to-your-project) - Brief description
   

3. プルリクエストを送信します

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルをご覧ください。

謝辞

• Model Context Protocol - プロトコル仕様
• MCP TypeScript SDK - 公式 TypeScript SDK
• FastMCP - 基盤となる MCP フレームワーク