Weather MCP Server

Weather MCP Server

世界中の都市の天気情報を提供する Model Context Protocol（MCP）サーバーです。

Features

• あらゆる都市の現在の天気を取得します
• 気温、天候、湿度、風の情報などを提供します
• API リクエストに失敗した場合は、モックデータにフォールバックします

Requirements

• Node.js（v14 以降）
• npm または yarn
• OpenWeather API キー（省略可。指定されていない場合はモックデータを使用します）

Installation

1. このリポジトリをクローンします
2. 依存関係をインストールします：

   npm install
   

3. サーバーをビルドします：

   npm run build
   

Usage

ローカルでの実行

npm start

Claude またはその他の MCP 対応 AI アシスタントでの使用

以下の設定を MCP 設定に追加します：

{
  "mcpServers": {
    "weather-server": {
      "command": "node",
      "args": ["path/to/weather-server/build/index.js"],
      "env": {
        "OPENWEATHER_API_KEY": "your-api-key-here" // Optional - will use mock data if not provided
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

API キーとモックデータ

このサーバーは、次の 2 つのモードで動作します：

1. API キーあり：OPENWEATHER_API_KEY 環境変数で OpenWeather API キーが指定されている場合、サーバーは OpenWeather API からリアルタイムの天気データを取得します。

2. API キーなし：API キーが指定されていない場合、サーバーは事前に定義された都市（London、New York、Tokyo、Paris、Sydney）のモックデータを自動的に使用します。それ以外の都市には、デフォルトのモックデータを使用します。

OpenWeather API キーを取得するには：

1. OpenWeather に登録します
2. アカウントの「API keys」セクションに移動します
3. 新しい API キーを生成するか、既存のキーを使用します

モックデータモードは、開発やテストを行う場合、またはリアルタイムの天気データが不要な場合に便利です。

使用可能なツール

get_current_weather

指定した都市の現在の天気情報を取得します。

入力スキーマ：

{
  "city": "string" // City name (e.g., "London", "New York", "Tokyo")
}

レスポンス例：

{
  "location": "London, GB",
  "date": "Monday, March 24, 2025",
  "time": "7:30:00 PM",
  "temperature": {
    "current": "12°C",
    "feelsLike": "10°C"
  },
  "weather": {
    "main": "Cloudy",
    "description": "Overcast clouds",
    "icon": "https://openweathermap.org/img/wn/[email protected]"
  },
  "details": {
    "humidity": "75%",
    "pressure": "1012 hPa",
    "windSpeed": "4.5 m/s",
    "windDirection": "230°",
    "cloudiness": "90%",
    "sunrise": "6:45 AM",
    "sunset": "7:30 PM"
  },
  "source": "OpenWeather API" // or "Mock Data (No API key provided)" or "Mock Data (API request failed)"
}

レスポンスの source フィールドは、データの取得元を示します：

• "OpenWeather API"：OpenWeather API から取得したリアルタイムデータ
• "Mock Data (No API key provided)"：API キーが指定されていないため使用されたモックデータ
• "Mock Data (API request failed)"：API リクエストに失敗したため使用されたモックデータ

ライセンス

MIT