Weather MCP Server

Weather MCP サーバー

National Weather Service API を使用して天気情報を提供するシンプルな MCP（Model Context Protocol）サーバーです。このサーバーでは、次の 2 つのツールを利用できます。

• get_alerts：米国の州の気象警報を取得します
• get_forecast：特定の場所の天気予報を取得します

前提条件

• Python 3.10 以降
• uv パッケージマネージャー（推奨）または pip

インストール

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

git clone <your-repo-url>
cd simple_mcp_server

2. Python 環境をセットアップします。

uv を使用する場合（推奨）：

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create and activate virtual environment
uv venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate

# Install dependencies
uv add "mcp[cli]" httpx

または、pip を使用する場合：

python -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate
pip install "mcp[cli]" httpx

使用方法

1. サーバーを実行します。

mcp dev main.py

2. Claude for Desktop を設定します。

   • ~/Library/Application Support/Claude/claude_desktop_config.json にある Claude for Desktop アプリの設定を開きます
   • 次の設定を追加します。

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

   • /ABSOLUTE/PATH/TO/simple_mcp_server をプロジェクトディレクトリの実際のパスに置き換えます
   • ファイルを保存し、Claude for Desktop を再起動します

3. サーバーをテストします。

   • Claude for Desktop を開きます
   • インターフェースにあるハンマーアイコンを探します
   • get_alerts と get_forecast の 2 つのツールが一覧に表示されます
   • 次のような質問をしてみてください。
     • 「NY の天気は？」
     • 「NY で現在発令されている気象警報は？」

利用可能なツール

get_alerts

米国の州の気象警報を取得します。

パラメーター：

• state (str)：米国の 2 文字の州コード（例：'CA'、'NY'）

get_forecast

特定の場所の天気予報を取得します。

パラメーター：

• latitude (float)：場所の緯度
• longitude (float)：場所の経度

トラブルシューティング

1. Claude for Desktop がサーバーを認識しない場合：

   • 設定ファイルのパスが正しいことを確認します
   • 設定に記載した絶対パスが正しいことを確認します
   • すべての依存関係がインストールされていることを確認します
   • Claude for Desktop を再起動してみます

2. 天気 API のエラーが発生する場合：

   • インターネット接続を確認します
   • 座標または州コードが有効であることを確認します
   • National Weather Service API は米国内の場所でのみ利用できます