Weather MCP 🌤️

Weather MCP 🌤️

MCP（Multi-Cloud Platform）を使用して構築された最新の気象サービスです。リアルタイムの気象データと警報を提供します。

🌟 機能

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

🚀 はじめに

前提条件

• Node.js（v18 以降）
• MCP サーバー
• Git

インストール

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

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

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

npm install && npm run build

💻 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 サーバーを設定して起動すると、自然言語で問い合わせて気象サービスを利用できます。次に例を示します。

クエリの例

• 「サクラメントの天気はどうですか？」
• 「テキサス州で現在発令中の気象警報はありますか？」
• 「サンフランシスコの予報はどうですか？」
• 「CA の気象警報を表示してください」

注：このサービスは米国国立気象局の API を使用するため、米国内の場所に対するクエリのみ機能します。

内部の仕組み

クエリを送信すると、次の処理が行われます。

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

よくある問題のトラブルシューティング

ツールが想定どおりに動作しない場合：

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

🤝 貢献

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

📝 ライセンス

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