Japanese Weather MCP

🚀 日本気象MCPサーバー

このModel Context Protocol (MCP)サーバーは、weather.tsukumijima.net APIを使用して、日本の天気予報にアクセスできるようにします。

✨ 主な機能

• 🌤️ 日本の都市の天気予報を取得
• 📍 東京、大阪、京都などの主要な日本の都市をサポート
• 📊 気温、降水確率、風況などの詳細な天気情報
• 🏢 気象庁から提供されるデータ
• 🔧 天気クエリに便利なMCPツール

📦 インストール

Smitheryを通じたインストール

Smitheryを通じてClaude Desktopに自動でjapanese-weather-mcpをインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @kongyo2/japanese-weather-mcp --client claude

手動インストール

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

git clone https://github.com/kongyo2/Japanese-Weather-MCP
cd weather-mcp-server

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

npm install

3. プロジェクトをビルドします。

npm run build

💻 使用例

開発モード

開発モードでサーバーを起動するには、以下のコマンドを実行します。

npm run dev

本番モード

サーバーをビルドして起動するには、以下のコマンドを実行します。

npm run build
npm start

利用可能なツール

1. get_weather_forecast

日本の都市の市IDを使用して、その都市の天気予報を取得します。 パラメーター:

• cityId (文字列): 日本の都市の市ID（例: 東京の場合は'130010'） 例:

{
  "cityId": "130010"
}

2. get_available_city_ids

日本の一般的な都市の利用可能な市IDのリストを取得します。 パラメーター: なし 返り値: 利用可能な市IDとそれに対応する都市名のリスト

3. get_weather_by_city_name

日本の一般的な都市の名前を使用して、その都市の天気予報を取得します。 パラメーター:

• cityName (列挙型): 日本の都市の名前
  • オプション: TOKYO, OSAKA, KYOTO, FUKUOKA, SAPPORO, NAGOYA, YOKOHAMA, KOBE, KAWASAKI, HIROSHIMA 例:

{
  "cityName": "TOKYO"
}

一般的な市ID

詳細な市IDについては、こちらを参照してください。

天気データ構造

天気予報には以下の情報が含まれます。

• 基本情報:
  • 発表時間と発表官署
  • 所在地の詳細（都道府県、市、地区）
• 予報データ（3日間）:
  • 天気状況（telop）
  • 気温（摂氏と華氏の最高/最低）
  • 降水確率（6時間間隔）
  • 詳細な天気情報
  • 風況
  • 波高（沿岸地域の場合）
• 追加情報:
  • 天気アイコン（SVG形式）
  • 気象庁の公式天気ページへのリンク

APIソース

このMCPサーバーは、weather.tsukumijima.net APIを使用しています。このAPIは以下の特徴があります。

• Livedoor Weather API互換形式
• 気象庁からのデータ
• APIキー不要
• 無料で利用可能

レート制限

APIを使用する際は、以下のことに注意してください。

• カスタムUser-Agentヘッダーを使用する
• 連続した高速なリクエストを避ける
• リクエスト間に少なくとも0.5秒の間隔を空ける

エラーハンドリング

サーバーには包括的なエラーハンドリングが組み込まれています。

• ネットワーク接続問題
• 無効な市ID
• APIサービスの利用不可
• データ解析エラー

開発

プロジェクト構造

weather-mcp-server/
├── src/
│   ├── server.ts          # 主なMCPサーバーの実装
│   └── weather-api.ts     # 天気APIクライアント
├── package.json
├── tsconfig.json
└── README.md

ビルド

npm run build

テスト

npm test

リント

npm run lint

フォーマット

npm run format

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

コントリビューション

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. 必要に応じてテストを追加する
5. プルリクエストを送信する

謝辞

• 天気APIを提供してくれたweather.tsukumijima.net
• 天気データを提供してくれた気象庁
• MCPフレームワークを提供してくれたFastMCP

サポート

問題が発生した場合や質問がある場合は、以下の手順を試してください。

1. weather.tsukumijima.netのドキュメントを確認する
2. 利用可能な市IDを確認する
3. 適切なレート制限を確認する
4. このリポジトリにイシューを登録する