Roc Cwa MCP

🚀 台湾中央気象局 MCP サーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）サーバーを提供します。このサーバーは台湾中央気象局（CWA）のAPIインターフェースに接続し、台湾の天気データを簡単に取得できるようにします。

English Version

📚 CWA API リソース

このプロジェクトを使用するには、中央気象局からAPIキーを取得する必要があります。

• CWA オープンデータプラットフォーム：https://opendata.cwa.gov.tw/index
• API ドキュメント：https://opendata.cwa.gov.tw/dist/opendata-swagger.html
• API キー申請ガイド：https://www.hlbh.hlc.edu.tw/resource/openfid.php?id=38959

✨ 主な機能

• 台湾の各県市の今後3日間の天気予報データを取得
• 台湾の各県市の今後1週間の天気予報データを取得
• 過去3日間の降雨履歴データを取得
• 自動的にデータのクリーニングと形式変換を行う
• 必要な情報のみを含む簡素化されたAPI出力

🛠️ システム要件

• Python 3.10+
• MCP CLI 1.6.0+
• uv パッケージマネージャー

📦 インストール

1. Python 3.10 以上がインストールされていることを確認します。

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

# uvを使用してプロジェクトの依存関係をインストール
uv pip install -e .

💻 使用例

サーバーの起動

Windows ユーザー

# コマンドプロンプトまたはPowerShellで実行
uv --directory あなたのプロジェクトパス run src/server.py あなたのAPIキー

Mac と Linux ユーザー

# ターミナルで実行
uv --directory あなたのプロジェクトパス run src/server.py あなたのAPIキー

利用可能な MCP ツール

このサーバーは以下の3つの主要なツールを提供します。

1. get_3_days_weather

指定した県市の今後3日間の天気予報データを取得します。

パラメータ：

• location_name (文字列)：県市名。有効な台湾の県市名である必要があります。

有効な県市名には、宜蘭県、花蓮県、台東県、澎湖県、金門県、連江県、台北市、新北市、桃園市、台中市、台南市、高雄市、基隆市、新竹県、新竹市、苗栗県、彰化県、南投県、雲林県、嘉義県、嘉義市、屏東県が含まれます。

2. get_1_week_weather

指定した県市の今後1週間の天気予報データを取得します。

パラメータ：

• location_name (文字列)：県市名。有効な台湾の県市名である必要があります。

3. get_rainfall_data

過去3日間の降雨履歴データを取得します。

追加のパラメータは必要ありません。

📊 API データソース

このプロジェクトでは、台湾中央気象局が提供する以下のオープンデータAPIを使用しています。

• 今後3日間の予報：台湾の郷鎮市天気予報 - 3日間天気予測（3時間間隔）
• 今後1週間の予報：台湾の郷鎮市天気予報 - 1週間天気予報
• 降雨データ：自動気象観測所 - 降雨観測データ