Weather MCP

🚀 Weather MCP 🌤️

Weather MCPは、MCP（Multi-Cloud Platform）を用いて構築された最新の天気サービスです。リアルタイムの天気データとアラートを提供します。

🚀 クイックスタート

前提条件

• Node.js (v18 以上)
• MCP Server
• Git

インストール

1. リポジトリをクローンします：

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

2. 依存関係をインストールし、プロジェクトをビルドします：

npm install && npm run build

✨ 主な機能

• 🌡️ リアルタイムの天気予報
• ⚠️ 州ごとの天気アラート
• 📍 位置情報に基づく天気情報
• 🔄 使いやすいAPIエンドポイント

💻 使用例

基本的な使用法

MCPサーバーを使用したローカル開発

MCPサーバーの設定

1. プロジェクトディレクトリに .cursor/mcp.json ファイルを作成し、以下の内容を記述します：

{
  "mcpServers": {
    "weather-service": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather/build/index.js"],
    }
  }
}

ここで、/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather/build/index.js は、weather-mcpプロジェクトの build フォルダ内の index.js ファイルへのパスです。

あるいは、グローバル設定として、ホームディレクトリのルートに .cursor/mcp.json ファイルを作成することもできます。

MCPサーバーの起動

1. Cursor IDEでプロジェクトを開きます。
2. Cursor Settings > Features > MCP に移動します。
3. 天気サービスが利用可能なMCPサーバーのリストに表示されるはずです。
4. 必要に応じて、右上隅の更新ボタンをクリックしてツールリストを更新します。

天気サービスの使用

CursorでMCPサーバーを設定して起動した後、自然言語クエリを使用して天気サービスとやり取りすることができます。以下はいくつかの例です：

クエリ例

• "What's the weather in Sacramento?"（サクラメントの天気はどうですか？）
• "Are there any active weather alerts in Texas?"（テキサスに現在有効な天気アラートはありますか？）
• "What's the forecast for San Francisco?"（サンフランシスコの天気予報はどうですか？）
• "Show me weather alerts for CA"（カリフォルニア州の天気アラートを表示してください）

注意: このサービスは米国国立気象局のAPIを使用しているため、クエリは米国内の場所にのみ適用されます。

仕組み

クエリを行うと：

1. 質問がLLMに送信されます。
2. LLMが利用可能なツールを分析し、使用するツールを決定します。
3. クライアントがMCPサーバーを介して選択されたツールを実行します。
4. 結果がLLMに送信されます。
5. 自然言語の応答が作成され、表示されます。

一般的な問題のトラブルシューティング

ツールが期待通りに動作しない場合は：

• サーバーがエラーなくビルドおよび実行されることを確認してください。
• .cursor/mcp.json 内のパスが正しく絶対パスであることを確認してください。
• 必要に応じてCursor IDEを再起動してください。
• 米国外の座標に対しては、このサービスは米国内の場所のみをサポートしているため、エラーが返されます。
• トラフィックが多いときは、天気サービスAPIにレート制限がかかる場合があります。

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

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