Boot MCP

🚀 boot - mcp

このプロジェクトは、TypeScriptを用いたModel Context Protocol (MCP) アプリケーションを構築するための包括的な起動テンプレートです。

[![npm バージョン][npm-version-src]][npm-version-href] [![npm ダウンロード数][npm-downloads-src]][npm-downloads-href] [![バンドル][bundle-src]][bundle-href] [![JSDocs][jsdocs-src]][jsdocs-href] [![ライセンス][license-src]][license-href] [![JavaScript コードスタイル][code-style-image]][code-style-url]

🚀 クイックスタート

このテンプレートには、異なるトランスポートのMCPサーバーの例が含まれています。

• Stdioトランスポート（コマンドラインツールや直接的な統合に使用）
• SSE付きのHTTPトランスポート（リモートサーバー用）

サンプルサーバーの実行

# 基本的なstdioサーバーを起動
pnpm start:basic

# HTTPサーバーを起動
pnpm start:http

✨ 主な機能

リソース

• テキストおよびバイナリリソースのサポート
• ツール付きの動的リソース
• 標準的なリソースタイプ（テキスト、JSONなど）
• カスタムリソースを作成するためのファクトリ関数
• コンテキスト内でのリソースアクセス

ツール

• コンテキスト付きのコマンド実行ツール
• ツールチェーンの実装
• ラボ環境の設定
• 動的なツールのロードとアンロード

プロンプト

• プロンプト用のテンプレート文字列
• テンプレート拡張のサポート
• コンテキスト変数の注入
• プロンプト履歴
• コールバックのサポート

ルート

• コンテキストルートの定義
• 標準的なコンテキスト属性
• 動的なコンテキスト拡張
• 親子コンテキストの継承
• コンテキストシーケンスの管理

トランスポート

• 標準的なトランスポートの実装（HTTPなど）
• カスタムトランスポートの開発
• トランスポートプロトコルの標準化
• トランスポート性能の最適化
• トランスポートのログ記録とトラッキング

サンプリング

• LLMリクエストの完了
• コンテキスト付きのサンプリング
• サンプリング結果の処理
• サンプリング戦略の実装
• 多言語サポート

📦 インストール

# npm
npm install

# pnpm
pnpm install

# yarn
yarn install

📚 ドキュメント

MCPとは？

Model Context Protocol (MCP) を使用すると、LLMアプリケーションにデータと機能を安全かつ標準的な方法で提供するサーバーを構築できます。これは、Web APIのようなものですが、LLMとのやり取りに特化しています。MCPサーバーは以下のことができます。

• リソース（GETエンドポイントに似ています。LLMのコンテキストに情報をロードするために使用されます）を介してデータを公開する
• ツール（POSTエンドポイントに似ています。コードを実行したり副作用を生み出したりするために使用されます）を介して機能を提供する
• プロンプト（LLMとのやり取りの再利用可能なテンプレート）を介してやり取りのパターンを定義する
• ルート（サーバーの操作範囲を定義する）を介して管理する
• サンプリング（サーバーがLLMからの完了を要求できるようにする）を介してエージェント動作を有効にする
• トランスポート（クライアントとサーバー間の通信メカニズム）を介して接続を確立する

プロジェクト構造

boot-mcp/
├── src/
│   ├── index.ts          # メインエントリポイント
│   ├── server/           # MCPサーバーの実装
│   │   ├── basic.ts      # 一般的な機能を持つ基本サーバー
│   │   └── http.ts       # SSE付きのHTTPトランスポートサーバー
│   ├── resources/        # リソースの実装
│   │   └── index.ts      # 様々な標準的なリソースタイプとツール
│   ├── tools/            # ツールの実装
│   │   └── index.ts      # カテゴリ別に整理された様々なツール
│   ├── prompts/          # プロンプトの実装
│   │   └── index.ts      # 一般的なプロンプトテンプレートとワークフロー
│   ├── roots/            # ルート管理
│   │   └── index.ts      # ルート定義とツール
│   ├── transports/       # トランスポートの実装
│   │   └── index.ts      # StdioおよびHTTP/SSEトランスポート
│   └── sampling/         # サンプリングユーティリティ（実験的）
│       └── index.ts      # LLMサンプリング機能
├── examples/             # サンプルの使用方法
│   ├── basic-server.ts   # 基本的なstdioサーバーの例
│   └── http-server.ts    # HTTPサーバーの例
└── test/                 # テスト

📄 ライセンス

MIT License