Weather MCP Server

Weather MCP Server

これは、Model Context Protocol（MCP）の概念を探求する学習プロジェクトです。National Weather Service（NWS）APIを使用して、気象警報と予報を提供するシンプルな気象サービスを実装しています。

このプロジェクトについて

このプロジェクトは、次のドキュメントに従ってMCP（Model Context Protocol）の学習と実装を行う演習として作成されました。 https://modelcontextprotocol.io/quickstart/server#core-mcp-concepts

MCPは、AI アシスタントが外部のツールやデータソースにアクセスできるようにするプロトコルです。このプロジェクトでは、ClaudeやほかのMCP対応アシスタントで使用できるMCP サーバーの作成方法を紹介します。

機能

• get_alerts：米国の州の有効な気象警報を取得します
• get_forecast：緯度と経度を使用して、特定の場所の天気予報を取得します

要件

• Python 3.9+
• httpxライブラリ
• mcpライブラリ

セットアップ手順

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

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

   pip install mcp httpx
   

   または、uvを使用します。

   uv pip install mcp httpx
   

3. MCP サーバーをAI アシスタントで設定します。

Claude Desktopの場合

次の内容をClaude Desktopの設定に追加します。

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
        "run",
        "weather.py"
      ]
    }
  }
}

Cursorの場合

Cursor Settings -> MCP Servers -> Add MCP Serverに移動します

• 名前：Weather（または任意の名前）
• タイプ：Command
• コマンド：uv run /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather/weather.py

使用例

MCP サーバーを設定すると、AI アシスタントに次のように尋ねることができます。

• 「CAの現在の気象警報は何ですか？」
• 「緯度37.7749、経度-122.4194の天気予報を教えてください」

ライセンス

このプロジェクトは教育目的で作成されています。

謝辞

• 気象データを提供するNational Weather Service（NWS）API
• サーバー実装の参考となるMCPドキュメント