MCP Server Template

🚀 MCP サーバーテンプレート

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

✨ 主な機能

• 🚀 TypeScript の包括的なサポート
• 🏗️ コンテナベースの依存性注入
• 📦 サービス指向アーキテクチャ、DataProcessor インターフェース付き
• 🛠️ サンプルツールの実装とテスト
• 🧪 Vitest テストフレームワーク
• 📝 型定義
• 🔌 MCP SDK の統合

📦 インストール

開発の開始

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

   npm install
   

2. ホットリロード付きの開発サーバーを起動します：

   npm run dev
   

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

   npm run build
   

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

   npm test
   

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

   npm start
   

📚 ドキュメント

プロジェクト構造

src/
├── index.ts          # エントリーポイント
├── interfaces/       # インターフェース定義
│   └── tool.ts      # DataProcessor インターフェース
└── tools/           # ツールの実装
    └── example.ts   # サンプルツール

ツールの作成

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

   // 在 your-tool.ts 中
   export const YOUR_TOOLS = [
     {
       name: "your-tool-name",
       description: "Your tool description",
       parameters: {
         // あなたのツールのパラメータースキーマ
       },
     },
   ];
   
   export const YOUR_HANDLERS = {
     "your-tool-name": async (request) => {
       // あなたのツールのハンドラーの実装
       return {
         toolResult: {
           content: [{ type: "text", text: "Result" }],
         },
       };
     },
   };
   

2. src/index.ts であなたのツールを登録します：

   // 在 src/index.ts 中
   import { YOUR_TOOLS, YOUR_HANDLERS } from "./tools/your-tool.js";
   
   // すべてのツールを結合する
   const ALL_TOOLS = [...EXAMPLE_TOOLS, ...YOUR_TOOLS];
   const ALL_HANDLERS = { ...EXAMPLE_HANDLERS, ...YOUR_HANDLERS };
   

サーバーは自動的に以下を行います：

• あなたのツールを利用可能なツールの一覧に表示します
• 入力検証を行います
• あなたのツールに対するリクエストを処理します
• MCP プロトコルに従ってレスポンスをフォーマットします

テスト

このテンプレートには、ローカルテスト用の TestClient と、ビジュアルデバッグ用の MCP Inspector が含まれています。

TestClient の使用

TestClient は、あなたのツールを簡単にテストする方法を提供します：

import { TestClient } from "./utils/TestClient";

describe("YourTool", () => {
  const client = new TestClient();

  it("should process data correctly", async () => {
    await client.assertToolCall(
      "your-tool-name",
      { input: "test" },
      (result) => {
        expect(result.toolResult.content).toBeDefined();
      }
    );
  });
});

MCP Inspector の使用

このテンプレートには、ツールをデバッグするための MCP Inspector が含まれています：

1. inspector を起動します：

   npx @modelcontextprotocol/inspector node dist/index.js
   

2. http://localhost:5173 で inspector の UI を開きます

Inspector は以下を提供します：

• ツールをテストするためのビジュアルインターフェース
• リアルタイムのリクエスト/レスポンスモニタリング
• ツールのメタデータチェック
• 対話型テスト環境

Cursor を使用したローカルテスト

Cursor であなたの MCP サーバーをテストするには：

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

   npm run build
   npm run link
   

2. バイナリファイルが正常に動作することを確認します：

   npx example-mcp-tool
   

3. Cursor でサーバーを追加します：

   • Cursor の設定を開きます
   • 機能タブに移動します
   • 下部の MCP サーバーセクションまでスクロールします
   • 「サーバーを追加」をクリックします
   • 「コマンド」タイプを選択します
   • 名前を入力します（例：「ローカルサンプルツール」）
   • コマンドを入力します：npx example-mcp-tool
   • 確認をクリックします

4. Cursor の MCP サーバーセクションを確認し、サーバーが実行中と表示されていることを確認します。

注意：コードを変更した場合は、必ず再ビルドして再リンクしてください：

npm run build
npm run link

不要になったら、パッケージをアンインストールできます：

npm uninstall example-mcp-tool
rm -rf ~/.node_modules_bins/example-mcp-link

更新履歴

v1.0.0

• 最初のバージョンがリリースされました