MCP サーバー開発ガイド

概要

LLM が外部サービスと相互作用できるようにする、よく設計されたツールを備えた MCP (Model Context Protocol) サーバーを作成します。

高レベルワークフロー

フェーズ 1: 深い調査と計画

• MCP プロトコルドキュメントを学習: https://modelcontextprotocol.io/sitemap.xml
• 推奨スタック: リモートの場合は Streamable HTTP を使用した TypeScript、ローカルの場合は stdio
• reference/ ディレクトリからフレームワークドキュメントを読み込む

フェーズ 2: 実装

• プロジェクト構造をセットアップ(reference/ 内の言語固有ガイドを参照)
• コアインフラストラクチャを実装: API クライアント、エラーハンドリング、レスポンスフォーマット、ページネーション
• 適切な入出力スキーマとアノテーション付きのツールを実装

フェーズ 3: レビューとテスト

• コード品質レビュー (DRY、エラーハンドリング、型カバレッジ)
• MCP Inspector でビルドとテスト: npx @modelcontextprotocol/inspector

フェーズ 4: 評価を作成

• 10 個の複雑でリアルな評価質問を作成
• XML 評価ファイルとして出力

reference/ ディレクトリ内の参照ファイル:

• mcp_best_practices.md - コアガイドライン
• node_mcp_server.md - TypeScript パターンと例
• python_mcp_server.md - Python パターンと例
• evaluation.md - 評価作成ガイド