MCP 天気サーバー

AccuWeather API を使用して時間ごとおよび毎日の天気予報を提供するモデル コンテキスト プロトコル (MCP) サーバー。

クイックスタート

AccuWeather API キーが必要です (無料レベルあり)。
ここでサインアップしてアプリを作成し、キーを取得してください。

API キーを環境変数としてエクスポートします。

次に、次のコマンドで MCP Weather サーバーを直接実行します。

または、スーパーゲートウェイ経由の HTTP/REST アクセスの場合:

MCP サーバー設定例

Claude Desktop またはその他の MCP 互換クライアントと統合するには、これを構成に追加します (例: claude_desktop_config.json )。

概要

このMCPサーバーは、Claudeのような大規模言語モデルがリアルタイムの気象データにアクセスすることを可能にします。LLMと統合することで、モデルは以下のことが可能になります。

• 正確で最新の天気予報を取得します

• 今後12時間の1時間ごとの天気データを提供する

• 最大15日間の毎日の天気予報にアクセス

• データをメートル法（°C）とヤードポンド法（°F）の両方で表示します

• 気温、天候、降水量情報、その他の天気の詳細を表示します

前提条件

• Node.js ≥18

• AccuWeather API キー ( .envまたはシェル経由で設定)

設定

1. このリポジトリをクローンします:

   git clone https://github.com/TimLukaHorstmann/mcp-weather.git cd mcp-weather

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

   npm install

3. AccuWeather API キーを取得します。

   • AccuWeather APIに登録する

   • 新しいアプリを作成し、APIキーを取得する

4. API キーを使用して

   ACCUWEATHER_API_KEY=your_api_key_here

5. プロジェクトをビルドします。

   npm run build

Claude Desktopでの使用

1. この MCP サーバーを使用するように Claude Desktop を構成します。

   • クロードデスクトップを開く

   • 設定 > 開発者 > 設定の編集に移動します

   • claude_desktop_config.jsonに以下を追加します。

   { "mcpServers": { "weather": { "command": "npx", "args": ["-y", "@timlukahorstmann/mcp-weather"], "env": { "ACCUWEATHER_API_KEY": "your_api_key_here" } } } }

2. Claudeデスクトップを再起動します

3. 新しい会話で、プラグアイコンをクリックして「天気」を選択し、MCPサーバーを有効にします。

4. 次のような天気予報をクロードに尋ねることができるようになりました。

   • 「ニューヨーク市の1時間ごとの天気予報はどうですか？」

   • 「ロンドンの5日間の天気予報をください。」

   • 「今週の東京の天気は華氏でどうなりますか？」

   • 「明日サンフランシスコは雨が降りますか？」

利用可能なツール

1時間ごとの天気予報

• ツール名: weather-get_hourly

• 今後12時間の1時間ごとの予報を提供します

• パラメータ:

  • sessionId (必須): セッションの一意の識別子

  • location （必須）: 市または場所の名前

  • units （オプション）: 「メートル法」（摂氏、デフォルト）または「帝国法」（華氏）

毎日の天気予報

• ツール名: weather-get_daily

• 最大15日間の毎日の予報を提供します

• パラメータ:

  • sessionId (必須): セッションの一意の識別子

  • location （必須）: 市または場所の名前

  • days （オプション）：予測日数（1、5、10、または15。デフォルトは5）

  • units （オプション）: 「メートル法」（摂氏、デフォルト）または「帝国法」（華氏）

発達

• 開発依存関係をインストール: npm install

• コードをLintする: npm run lint

• ビルド: npm run build

• テストを実行: npm test

• 開発モードで起動: npm run dev

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

将来の機能強化

MCP Weather Server は常に改善に取り組んでいます。今後のリリースで検討している機能は以下のとおりです。

• 拡張時間別予報: 12 時間を超える、たとえば 24 時間または 48 時間。

• 気象警報: AccuWeather の悪天候警報 API との統合。

• **場所のオートコンプリート:**オートコンプリートの提案による場所の検索が改善されました。

• **過去の気象データ:**過去の気象状況にアクセスできます。

他の機能についてのアイデアがある場合は、お気軽に問題を報告してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。