TypeScript MCP サーバーの生成

次の仕様に従って、完全な Model Context Protocol (MCP) サーバーを TypeScript で作成します:

要件

1. プロジェクト構造: 適切なディレクトリ構造を持つ新しい TypeScript/Node.js プロジェクトを作成
2. NPM パッケージ: @modelcontextprotocol/sdk、zod@3、および HTTP 用の express または stdio サポートを含める
3. TypeScript 構成: ES モジュールをサポートする適切な tsconfig.json
4. サーバータイプ: HTTP (Streamable HTTP transport を使用) または stdio ベースのサーバーから選択
5. ツール: 適切なスキーマ検証を備えた有用なツールを少なくとも 1 つ作成
6. エラーハンドリング: 包括的なエラーハンドリングと検証を含める

実装詳細

プロジェクト設定

• npm init で初期化し、package.json を作成
• 依存関係をインストール: @modelcontextprotocol/sdk、zod@3、トランスポート固有のパッケージ
• TypeScript を設定: package.json に "type": "module" を設定
• 開発依存関係を追加: 開発用に tsx または ts-node
• 適切な .gitignore ファイルを作成

サーバー構成

• 高レベルの実装に McpServer クラスを使用
• サーバー名とバージョンを設定
• 適切なトランスポートを選択 (StreamableHTTPServerTransport または StdioServerTransport)
• HTTP の場合: 適切なミドルウェアとエラーハンドリングを備えた Express をセットアップ
• stdio の場合: StdioServerTransport を直接使用

ツール実装

• registerTool() メソッドを説明的な名前で使用
• 入出力検証に zod を使用してスキーマを定義
• 明確な title と description フィールドを提供
• 結果に content と structuredContent の両方を返す
• try-catch ブロックで適切なエラーハンドリングを実装
• 必要に応じて非同期操作をサポート

リソース/プロンプト設定 (オプション)

• 動的 URI に ResourceTemplate を使用して registerResource() でリソースを追加
• 引数スキーマを使用して registerPrompt() でプロンプトを追加
• より良い UX のため completion サポートの追加を検討

コード品質

• 型安全性のために TypeScript を使用
• async/await パターンを一貫して使用
• トランスポート close イベント時に適切なクリーンアップを実装
• 構成に環境変数を使用
• 複雑なロジックにはインラインコメントを追加
• 関心事の明確な分離を備えたコード構造

検討すべきツールタイプの例

• データ処理と変換
• 外部 API 統合
• ファイルシステム操作 (読み取り、検索、分析)
• データベースクエリ
• テキスト分析または要約 (サンプリング付き)
• システム情報の取得

構成オプション

• HTTP サーバーの場合:

  • 環境変数経由のポート設定
  • ブラウザクライアント向けの CORS セットアップ
  • セッション管理 (ステートレス vs ステートフル)
  • ローカルサーバー向けの DNS リバインディング保護

• stdio サーバーの場合:

  • 適切な stdin/stdout ハンドリング
  • 環境ベースの構成
  • プロセスライフサイクル管理

テスト ガイダンス

• サーバーの実行方法を説明 (npm start または npx tsx server.ts)
• MCP Inspector コマンドを提供: npx @modelcontextprotocol/inspector
• HTTP サーバーの場合、接続 URL を含める: http://localhost:PORT/mcp
• ツール呼び出しの例を含める
• 一般的な問題のトラブルシューティングのヒントを追加

検討すべき追加機能

• LLM 搭載ツール向けのサンプリングサポート
• インタラクティブなワークフロー向けのユーザー入力の引き出し
• 有効/無効機能を備えた動的ツール登録
• 一括更新用の通知デバウンシング
• 効率的なデータ参照のためのリソースリンク

包括的なドキュメント、型安全性、エラーハンドリングを備えた完全で本番環境対応の MCP サーバーを生成します。