Home - HiroyukiMakita/mcp-server-tutorial GitHub Wiki

MCPサーバー構築チュートリアル

概要

このチュートリアルでは、Model Context Protocol (MCP) を使用して天気情報を提供するMCPサーバーを構築する方法を学びます。OpenWeatherMap APIを活用し、指定した都市の現在の天気と予報を取得できるサーバーを段階的に実装していきます。

対象読者

  • Node.js/TypeScriptの基本を理解している開発者
  • MCPを使用したサーバー開発に興味がある方
  • Web APIの利用経験がある方

学習内容

このチュートリアルでは以下の内容を学びます：

  1. MCPの基本概念と利点
  2. TypeScriptを使用したMCPサーバーの実装
  3. Zodによる型安全な入力バリデーション
  4. 外部APIとの連携（OpenWeatherMap API）
  5. ユニットテストの作成と実行（Vitest）
  6. エラーハンドリングとロギング

チュートリアルの進め方

以下の順序でページを読み進めることをお勧めします：

  1. はじめに
  2. MCPとは？
  3. チュートリアルで作成するもの
  4. 開発環境の準備
  5. MCPサーバープロジェクトの作成
  6. MCPサーバーの実装 - APIキー設定と準備
  7. MCPサーバーの実装 - 型定義
  8. MCPサーバーの実装 - APIクライアント
  9. MCPサーバーの実装 - MCPツール定義
  10. MCPサーバーの実装 - エラーハンドリング
  11. MCPサーバーの実装 - メイン処理とユニットテスト
  12. MCPサーバーのビルドと実行
  13. MCP設定ファイルへの登録と動作確認

発展的な内容

基本的な実装が完了した後は、以下の発展的なトピックも用意しています：

必要な開発環境

  • Node.js (v18以上を推奨)
  • npm または yarn
  • テキストエディタ（VSCode推奨）
  • Git
  • OpenWeatherMap APIキー（無料で取得可能）

所要時間の目安

基本的な実装部分（1-13）: 約2-3時間 発展的な内容（14-18）: 約1-2時間