MCP サーバー テンプレート

TypeScriptでモデルコンテキストプロトコル（MCP）サーバーを作成するためのテンプレートです。このテンプレートは、適切なツール、型安全性、そしてベストプラクティスを用いて、MCP互換サーバーを構築するための強固な基盤を提供します。

特徴

• 🚀 TypeScriptの完全サポート

• 🏗️ コンテナベースの依存性注入

• 📦 DataProcessor インターフェースを使用したサービスベースのアーキテクチャ

• 🛠️ テストを含むツール実装の例

• 🧪 Vitest テストフレームワーク

• 📝 型定義

• 🔌 MCP SDK 統合

Related MCP server: MCP Server Template

はじめる

発達

1. 依存関係をインストールします:

   npm install

2. ホット リロードで開発サーバーを起動します。

   npm run dev

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

   npm run build

4. テストを実行します:

   npm test

5. 本番サーバーを起動します。

   npm start

プロジェクト構造

ツールの作成

1. src/tools/example.tsの例に従って、ツールとハンドラーをエクスポートします。

   // In your-tool.ts export const YOUR_TOOLS = [ { name: "your-tool-name", description: "Your tool description", parameters: { // Your tool parameters schema }, }, ]; export const YOUR_HANDLERS = { "your-tool-name": async (request) => { // Your tool handler implementation return { toolResult: { content: [{ type: "text", text: "Result" }], }, }; }, };

2. src/index.tsのALL_TOOLSおよびALL_HANDLERS定数にツールを登録します。

   // In src/index.ts import { YOUR_TOOLS, YOUR_HANDLERS } from "./tools/your-tool.js"; // Combine all tools const ALL_TOOLS = [...EXAMPLE_TOOLS, ...YOUR_TOOLS]; const ALL_HANDLERS = { ...EXAMPLE_HANDLERS, ...YOUR_HANDLERS };

サーバーは自動的に次の処理を実行します。

• 利用可能なツールにツールをリストします

• 入力検証を処理する

• ツールへのリクエストを処理する

• MCPプロトコルに従って応答をフォーマットする

テスト

テンプレートには、ローカル テスト用の組み込み TestClient と視覚的なデバッグ用の MCP Inspector が含まれています。

TestClientの使用

TestClient はツールをテストする簡単な方法を提供します。

MCPインスペクターの使用

テンプレートには、ツールを視覚的にデバッグするための MCP インスペクターが含まれています。

1. インスペクターを起動します。

   npx @modelcontextprotocol/inspector node dist/index.js

2. http://localhost:5173でインスペクターUIを開きます。

検査官は以下を提供します:

• テストツールのビジュアルインターフェース

• リアルタイムのリクエスト/レスポンス監視

• ツールメタデータ検査

• インタラクティブなテスト環境

カーソルを使ったローカルテスト

Cursor を使用して MCP サーバーをローカルでテストするには:

1. パッケージをビルドしてリンクします。

   npm run build npm run link

2. バイナリが動作することを確認します。

   npx example-mcp-tool

3. カーソルにサーバーを追加します。

   • カーソル設定を開く

   • 機能タブに移動します

   • MCPサーバーのセクションまでスクロールします

   • 「サーバーを追加」をクリックします

   • 「コマンド」タイプを選択

   • 名前を付けます（例：「ローカルサンプルツール」）

   • 次のコマンドを入力します: npx example-mcp-tool

   • 確認をクリック

4. MCP サーバー セクションでサーバーが実行中であることが表示されていることを確認し、カーソルでサーバーが正しく起動していることを確認します。

注意: コードを変更した場合は、必ず再構築して再リンクしてください。

テストが完了したら、パッケージのリンクを解除できます。

これにより、開発中に作成されたグローバル シンボリック リンクが削除されます。