Weather Forecast MCP Server

Weather Forecast MCP Server

National Weather Service（NWS）APIを使用して、米国の各州および英国の都市・町の気象情報と警報を提供する Model Context Protocol（MCP）サーバーです。このサーバーを使うと、AI アシスタントは標準化されたインターフェースを通じて、最新の天気予報や警報を取得できます。

Features

• 気象警報：米国の任意の州または英国の都市・町の有効な気象警報を取得します
• 天気予報：緯度と経度を使って詳細な天気予報を取得します
• API キーが必要：英国の気象サービスを利用するには API キーが必要です
• リアルタイムデータ：政府の公式情報源から最新の気象情報に直接アクセスできます
• MCP 対応：MCP 対応の AI アシスタントまたはクライアントであれば利用できます

Installation

ソースから

リポジトリをクローンして、依存関係をインストールします。

git clone https://github.com/MKhan997733/mcp-server-weather-forecast.git
cd mcp-server-weather-forecast
npm install
npm run build

Configuration

Claude Desktop

claude_desktop_config.json ファイルに次の設定を追加します。

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["mcp-server-weather-forecast"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor IDE

Cursor の MCP 設定にサーバーを追加します。

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["mcp-server-weather-forecast"],
      "disabled": false,
      "autoApprove": [],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

環境変数

次の環境変数が必要です。

• API_KEY：気象サービスにアクセスするための天気 API キー

API キーは OpenWeather から取得できます。

Usage

設定が完了したら、AI アシスタントに次のような天気に関する質問をできます。

• 「カリフォルニア州の現在の気象警報は？」
• 「ニューヨーク市の天気予報を教えて」
• 「テキサス州で厳しい気象警報は発令されていますか？」
• 「座標 40.7128, -74.0060 の天気予報は？」

利用可能なツール

get-alerts

米国の指定した州の気象警報を取得します。

パラメーター：

• state（string、必須）：米国の州を表す 2 文字のコード（例：「CA」、「NY」、「TX」）

例：

{
  "state": "CA"
}

get-forecast

座標を使って、指定した地点の天気予報を取得します。

パラメーター：

• latitude（number、必須）：地点の緯度（-90 から 90）
• longitude（number、必須）：地点の経度（-180 から 180）

例：

{
  "latitude": 37.7749,
  "longitude": -122.4194
}

current-weather-uk

英国の都市や町の現在の天気予報を取得します。

パラメーター：

• city（string、必須）：英国の都市または町の名前

例：

{
  "city": "London"
}

API の詳細

このサーバーでは、次の API を使用します。

• National Weather Service API：米国の気象警報と天気予報に使用します
• OpenWeather API：英国の気象情報およびその他の気象データに使用します

API キー： 気象サービスにアクセスするには API キーが必要です。OpenWeather から取得できます。

Development

前提条件

• Node.js 18+
• npm または yarn

開発環境での実行

# Install dependencies
npm install

# Build the project
npm run build

# Run the server with API key
API_KEY=your-api-key-here node <absolute-path>/build/index.js