Weather MCP Server

🚀 天気 MCP サーバー

このサーバーは、Model Context Protocol (MCP) を用いて、世界中の都市の天気情報を提供します。

✨ 主な機能

• 任意の都市の現在の天気を取得することができます。
• 温度、天気状況、湿度、風力などの情報を提供します。
• APIリクエストが失敗した場合、モックデータにフォールバックします。

📦 インストール

必要条件

• Node.js（v14 以上）
• npm または yarn
• OpenWeather API キー（オプション - 提供されない場合はモックデータが使用されます）

インストール手順

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

   npm install
   

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

   npm run build
   

💻 使用例

ローカルでの実行

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" // オプション - 提供されない場合はモックデータが使用されます
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

API キーとモックデータ

このサーバーは2つの動作モードがあります。

1. API キーを使用する場合：OPENWEATHER_API_KEY 環境変数で OpenWeather API キーを提供すると、サーバーは OpenWeather API からリアルタイムの天気データを取得します。
2. API キーを使用しない場合：API キーが提供されない場合、サーバーは事前定義された都市（ロンドン、ニューヨーク、東京、パリ、シドニー）に対しては実データを使用し、それ以外の都市に対してはデフォルトのモックデータを使用します。

OpenWeather API キーを取得するには、以下の手順を実行します。

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

API キーがない場合、モックデータモードは開発、テスト、またはリアルタイムの天気データを必要としない場合に最適です。

利用可能なツール

基本的な使用法

# get_current_weather関数を使って指定した都市の現在の天気情報を取得する
```json
{
  "city": "string" // 都市名（例：「ロンドン」、「ニューヨーク」、「東京」）
}

高度な使用法

# APIキーの有無に応じたデータ取得の挙動を理解し、適切に利用する
```json
{
  "mcpServers": {
    "weather-server": {
      "command": "node",
      "args": ["path/to/weather-server/build/index.js"],
      "env": {
        "OPENWEATHER_API_KEY": "your-api-key-here" // オプション - 提供されない場合はモックデータが使用されます
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

応答例

{
  "location": "London, GB",
  "date": "2025年3月24日，月曜日",
  "time": "午後7:30:00",
  "temperature": {
    "current": "12°C",
    "feelsLike": "10°C"
  },
  "weather": {
    "main": "曇り",
    "description": "くもりがち",
    "icon": " cloudy "
  },
  "wind": {
    "speed": 15,
    "direction": 270
  },
  "humidity": 80,
  "source": "openweather" // データソース識別子（openweather またはモックデータ）
}

応答内容の説明

• location：都市とその国の識別子です。
• date と time：天気データが取得された日付と時間です。
• temperature：現在の温度と体感温度です。
• weather：現在の天気状況で、主要な説明とアイコンが含まれます。
• wind：風速と方向（度数で表され、0 - 360度）です。
• humidity：相対湿度のパーセンテージです。
• source：データソースの識別子で、openweather またはモックデータを示します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。