MCP Server Template

MCP サーバーテンプレート

Express.js と TypeScript で構築された、軽量で拡張性の高い MCP（Model Context Protocol）サーバー実装です。このテンプレートは、Server-Sent Events（SSE）を通じて MCP 対応クライアントと通信できる、AI を活用したアプリケーションを構築するための確かな基盤を提供します。

特長

• TypeScript に対応した Express.js サーバー
• リアルタイム通信のための Server-Sent Events（SSE）
• MCP プロトコルの実装
• メモ管理システム
• Docker のサポート
• Zod を使用した入力検証

前提条件

• Node.js 22 以降
• npm（Node Package Manager）
• Docker（任意）

インストール

1. リポジトリをクローンします。

git clone https://github.com/yourusername/mcp-template.git
cd mcp-template

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

サーバーの起動

ローカル開発

npm start

サーバーはデフォルトでポート 3123 で起動します。

Docker を使用する場合

Docker イメージをビルドします。

docker build -t mcp-template .

コンテナを実行します。

docker run -p 3123:3123 mcp-template

API エンドポイント

MCP エンドポイント

• GET /mcp/sse - MCP 通信のための SSE 接続を確立します

利用可能なツール

• add-note - ノートストアに新しいノートを追加します

  • パラメーター：
    • noteTitle: string - ノートのタイトル
    • noteContent: string - ノートの内容
    • noteTags: string[]（任意）- ノートのタグ

• update-note - 既存のノートを更新します

  • パラメーター：
    • noteId: string - 更新するノートの ID
    • noteTitle: string - 新しいノートのタイトル
    • noteContent: string - 新しいノートの内容
    • noteTags: string[]（任意）- 新しいノートのタグ

• get-note - 特定のノートを取得します

  • パラメーター：
    • noteId: string - 取得するノートの ID

• get-all-notes - ストア内のすべてのノートを取得します

  • パラメーター：なし

• delete-note - ストアからノートを削除します

  • パラメーター：
    • noteId: string - 削除するノートの ID

入力検証

サーバーは、実行時の型チェックと入力検証に Zod を使用します。すべての受信リクエストは、処理前に定義済みのスキーマに照らして検証されます。これにより、アプリケーション全体で型安全性とデータの整合性が確保されます。

環境変数

• PORT - サーバーのポート（デフォルト：3123）
• LOG_LEVEL - ログレベル（デフォルト："info"）
• DOCKER - Docker で実行する場合は "true" に設定します
• DEV - 開発モードでは "true" に設定します

開発

プロジェクト構成

src/
├── config.ts         # Configuration settings
├── index.ts         # Application entry point
├── logger.ts        # Logging configuration
├── note-store.ts    # Note management system
└── server/
    └── routers/
        └── mcp.ts   # MCP router implementation

ビルド

npm run build

Lint

npm run lint

ライセンス

MIT

作者

Antonio De Vivo