Simple Weather MCP Server

🚀 天気 MCP サーバー

これは、国家気象局の API を使用して天気情報を提供するシンプルな MCP（モデル制御プロトコル）サーバーです。このサーバーは以下の 2 つのツールを提供します。

• get_alerts：アメリカの特定の州の天気警報を取得します。
• get_forecast：特定の位置の天気予報を取得します。

🚀 クイックスタート

前提条件

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

インストール

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

git clone <your-repo-url>
cd simple_mcp_server

2. Python 環境を設定します。

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

# uv がインストールされていない場合は、まずインストールします。
curl -LsSf https://astral.sh/uv/install.sh | sh

# 仮想環境を作成してアクティブ化します。
uv venv
source .venv/bin/activate  # Windows の場合は：.venv\Scripts\activate

# 依存関係をインストールします。
uv add "mcp[cli]" httpx

pip を使用する場合：

python -m venv .venv
source .venv/bin/activate  # Windows の場合は：.venv\Scripts\activate
pip install "mcp[cli]" httpx

使用例

基本的な使用法

1. サーバーを起動します。

mcp dev main.py

2. Claude for Desktop を設定します。
   • Claude for Desktop アプリの設定ファイル ~/Library/Application Support/Claude/claude_desktop_config.json を開きます。
   • 以下の設定を追加します。

   {
     "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 エラーが発生した場合：
   • インターネット接続を確認します。
   • 座標または州コードが有効であることを検証します。
   • 国家気象局の API はアメリカ地域のみで利用可能です。