mcp-server-patterns

name	mcp-server-patterns
description	Build MCP servers with Node/TypeScript SDK — tools, resources, prompts, Zod validation, stdio vs Streamable HTTP. Use Context7 or official MCP docs for latest API.
origin	ECC

MCP サーバーパターン

Model Context Protocol（MCP）は、AI アシスタントがサーバーからツールを呼び出し、リソースを読み取り、プロンプトを使用することを可能にします。MCP サーバーの構築やメンテナンス時にこのスキルを使用してください。SDK API は進化しています。現在のメソッド名とシグネチャについては Context7（"MCP" で query-docs）または公式 MCP ドキュメントを確認してください。

ある機能をルール、スキル、MCP、あるいは単純な CLI/API ワークフローのいずれとして実装すべきか、という広い範囲のルーティング判断については docs/capability-surface-selection.md を参照してください。

使用タイミング

使用シーン: 新しい MCP サーバーの実装、ツールやリソースの追加、stdio vs HTTP の選択、SDK のアップグレード、MCP 登録やトランスポートの問題のデバッグ。

仕組み

コアコンセプト

• Tools: モデルが呼び出せるアクション（例: 検索、コマンド実行）。SDK バージョンに応じて registerTool() または tool() で登録します。
• Resources: モデルがフェッチできる読み取り専用データ（例: ファイル内容、API レスポンス）。registerResource() または resource() で登録します。ハンドラーは通常 uri 引数を受け取ります。
• Prompts: クライアントが表示できる再利用可能なパラメータ化されたプロンプトテンプレート（例: Claude Desktop 内）。registerPrompt() または同等のメソッドで登録します。
• Transport: ローカルクライアント（例: Claude Desktop）には stdio。リモート（Cursor、クラウド）には Streamable HTTP が推奨。レガシー HTTP/SSE は後方互換性のためのみ。

Node/TypeScript SDK は tool() / resource() または registerTool() / registerResource() を公開する場合があります。公式 SDK は時間とともに変更されています。常に現在の MCP ドキュメント または Context7 で検証してください。