MCP Weather Server Rfw

🚀 MCP 天気サーバー

MCP 天気サーバーは、モデルコンテキストプロトコル（MCP）に基づいて構築された天気サービスアプリケーションです。リアルタイムの天気データと警報情報にアクセスできます。

🚀 クイックスタート

前提条件

• Node.js (v18 以上)
• npm または yarn パッケージマネージャー

インストール手順

# リポジトリをクローンする
git clone https://github.com/cskiro/MCP-Weather-Server.git

# プロジェクトディレクトリに移動する
cd MCP-Weather-Server

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

# CLI ツールを実行可能にする
chmod +x build/index.js

# グローバルにインストールする（オプション）
npm install -g .

使用方法

このサーバーは2つの方法で使用できます。

1. 直接呼び出し：

weather

2. MCP 互換クライアント/アシスタントを介して： MCP クライアントを構成して、天気予報と天気警報のクエリに天気ツールを使用します。

✨ 主な機能

• アメリカの天気予報：緯度と経度のパラメータを使用して、アメリカの任意の場所の詳細な天気予報データを取得できます。
• 天気警報：指定されたアメリカの州内のアクティブな天気警報を照会できます。
• MCP 統合：MCP サーバーとして構築されており、AI アシスタントとのシームレスな統合を実現します。
• コマンドラインインターフェイス：簡単にインストールでき、実行しやすい CLI ツールです。

🔧 技術詳細

アーキテクチャ

このアプリケーションは、モデルコンテキストプロトコル（MCP）フレームワークに基づいて構築されています。

1. MCP サーバー層：MCP クライアントとの通信を担当します。
2. 天気ツール：予報と警報機能モジュールを実装しています。
3. 外部 API 統合：国家気象局（NWS）API に接続します。

コンポーネント構造

サーバーには2つの主要な天気ツールが含まれています。

• get-forecast：緯度と経度のパラメータに基づいて、指定された場所の詳細な天気予報を取得します。
• get-alerts：州名のパラメータに基づいて、指定された地域内のアクティブな天気警報を取得します。

これらのツールは、国家気象局 API との相互作用を通じて、信頼性の高いデータを提供します。

技術スタック

• Node.js
• TypeScript
• MCP SDK (@modelcontextprotocol/sdk)
• 国家気象局（NWS）API
• Zod（入力検証用）

💻 使用例

基本的な使用法

天気予報の取得

// 例：サンフランシスコの天気予報を取得する
{
  経緯度: {
    緯度: 37.7749,
    経度: -122.4194
  }
}

天気警報の取得

// 例：カリフォルニア州の天気警報を照会する
{
  州: "CA"
}

📚 ドキュメント

データソース

このサーバーは 国家気象局 API を使用しており、このデータソースはアメリカの公式天気情報を提供します。データソースの制限により、現在はアメリカ国内の場所の照会のみがサポートされています。

貢献ガイド

どんな貢献も歓迎します！Pull Request を通じてコードや提案を送信してください。

📄 ライセンス

このプロジェクトは ISC ライセンスの下で提供されています。詳細は LICENSE ファイルを参照してください。