My MCP Weather Server

My MCP Weather Server

このプロジェクトは、TypeScript 用の @modelcontextprotocol/sdk で構築された MCP（Model Context Protocol）サーバーのサンプルです。あらかじめ定義された複数の都市について、簡単なダミーの天気情報を提供するツールを公開する方法を紹介します。

このサーバーは、このサーバーが公開するツールを活用できる LLM 搭載エージェントなど、MCP 準拠のクライアントのバックエンドとして使用することを想定しています。

機能

• MCP 準拠： Model Context Protocol を実装しています。
• ストリーム可能な HTTP トランスポート： 通信には推奨されている StreamableHTTPServerTransport を使用します。
• ツールの公開： get_city_weather ツールを公開します。
  • 入力： city（文字列。例：「paris」、「london」、「tokyo」）と、任意の unit（列挙型：「metric」または「imperial」。デフォルトは「metric」）。
  • 出力： 気温、天気の説明、湿度などのダミーの天気情報を返します。
  • 構造化出力： クライアントが確実に解析できるよう、定義済みの outputSchema に一致する structuredContent を提供します。
• 基本的なセッション管理： StreamableHTTPServerTransport のシンプルなインメモリセッション処理を紹介します。

前提条件

• Node.js（MCP SDK の仕様により、v18 以降を推奨）
• npm（または yarn/pnpm）

セットアップ

1. リポジトリをクローンします（またはプロジェクトファイルを作成します）：

   # Git リポジトリにある場合：
   # git clone <your-repo-url>
   # cd my-mcp-weather-server
   
   # それ以外の場合は、src/server.ts、package.json、tsconfig.json を含むプロジェクトディレクトリがあることを確認してください
   

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

   npm install
   

サーバーの実行

開発環境の場合

このコマンドは、ts-node で TypeScript のソースを直接実行し、nodemon でファイルの変更時にサーバーを自動的に再起動します。

npm run build
npm start