Weather MCP Server

Weather MCP サーバー

概要

このプロジェクトでは、AI アシスタント（Claude など）が米国海洋大気庁（NWS）の API と連携できる Model Context Protocol（MCP）サーバーを実装しています。このサーバーは、指定した場所のリアルタイムの気象警報と予報を提供します。

機能

• 米国の指定した州で発令中の気象警報を取得します。
• 指定した緯度と経度の気象予報を取得します。
• FastMCP フレームワークを実装し、AI との連携に使用するツールを公開します。

使用技術

• Python
• FastMCP
• httpx（非同期 HTTP リクエスト用）

前提条件

このプロジェクトを実行する前に、以下を用意してください。

• Python がインストールされていること（バージョン 3.11.6 以上を推奨）
• uv パッケージマネージャー（pip install uv）
• httpx がインストールされていること（pip install httpx）
• fastmcp がインストールされていること（pip install fastmcp）
• Claude Desktop アプリ

uv パッケージマネージャーのインストール

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

PATH に追加

インストールとセットアップ

1. リポジトリをクローンします。 git clone https://github.com/ankushmehta123/weather-mcp-server.git

2. 依存関係をインストールします。 pip install -r requirements.txt

3. 以下を追加して MCP サーバーを設定します。 claude_desktop_config.json:

    "mcpServers": {
        "weather": {
            "command": "C:/Users/"enter_your_username"/.local/bin/uv.exe",
            "args": [
                "--directory",
                "directory_location of main.py",
                "run",
                "main.py"
            ]
        }
    }
   }
   

Usage

Run main.py python main.py

Available API Tools

Open Claude Desktop, you would see: 2 MCP tools available (at right-side of the search-bar)

You can ask real-time weather-related questions to Claude now