MCP

🚀 天気MCPサーバー 🌤️

このサーバーはModel Context Protocol (MCP)に基づいた天気検索サーバーで、ユーザーが入力した住所や自動取得した現在位置を元に、天気情報と予報を検索することができます。

✨ 主な機能

• 🌍 複数の位置検索方法：住所、座標、現在位置の検索に対応
• 🌤️ リアルタイムの天気情報：現在の詳細な天気データを取得
• 📅 天気予報：1～10日後までの天気予報に対応
• 📍 地理コーディング：住所と座標の相互変換が可能
• 💡 スマートな提案：天気条件に基づいた生活上の提案を提供
• 🌐 多言語対応：中国語のインターフェースで、世界中の住所検索に対応
• 🔧 統合が容易：標準のMCPプロトコルを使用し、様々なAIクライアントと互換性があります

📦 インストール

1. プロジェクトをクローンする

git clone <repository-url>
cd weather-mcp-server

2. 依存関係をインストールする

npm install

3. コンパイルと実行

🎉 APIキー不要！ このプロジェクトは完全に無料のOpen-Meteo APIを使用しており、登録やキーの設定は必要ありません。

# TypeScriptをコンパイルする
npm run build

# サーバーを起動する
npm start

# または開発モード（自動再コンパイル）
npm run dev

📚 ドキュメント

Claude Desktopでの使用方法

1. Claude Desktopの設定ファイルを開く：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

2. MCPサーバーの設定を追加する：

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/path/to/weather-mcp-server/dist/index.js"]
    }
  }
}

3. Claude Desktopを再起動する

その他のMCPクライアントでの使用方法

各クライアントのドキュメントを参照し、stdio伝送プロトコルを使用してサーバーに接続します：

node /path/to/weather-mcp-server/dist/index.js

🔧 利用可能なツール

1. get-weather-by-address

住所から現在の天気情報を取得します。

パラメーター:

• address (string): 住所。例："北京市"、"上海市浦东新区"、"New York"

使用例:

北京市の天気を取得

2. get-forecast-by-address

住所から天気予報を取得します。

パラメーター:

• address (string): 住所
• days (number, オプション): 予報の日数（1～10日、デフォルトは5日）

使用例:

上海市の未来7日間の天気予報を取得

3. get-current-location-weather

現在位置（IPアドレスに基づく）の天気情報を取得します。

パラメーター: なし

使用例:

現在位置の天気を取得

4. get-current-location-forecast

現在位置の天気予報を取得します。

パラメーター:

• days (number, オプション): 予報の日数（1～10日、デフォルトは5日）

使用例:

現在位置の未来3日間の天気予報を取得

5. get-weather-by-coordinates

緯度と経度の座標から天気情報を取得します。

パラメーター:

• latitude (number): 緯度（-90～90）
• longitude (number): 経度（-180～180）

使用例:

座標(39.9042, 116.4074)の天気情報を取得

6. geocode-address

住所を緯度と経度の座標に変換します。

パラメーター:

• address (string): 解析する住所

使用例:

「天安門広場」の座標を解析

📚 利用可能なリソース

weather://status

天気サービスの設定状態と可用性を表示します。

🎯 利用可能なヒント

weather-assistant

天気検索のスマートアシスタント

パラメーター:

• location (string, オプション): 位置情報
• query_type (enum, オプション): 検索タイプ、"current"または"forecast"

💻 使用例

基本的な使用法

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/path/to/weather-mcp-server/dist/index.js"]
    }
  }
}

高度な使用法

node /path/to/weather-mcp-server/dist/index.js

天気情報の出力例

📍 位置: Beijing, Beijing, China
🌡️ 温度: 22°C (体感温度: 24°C)
🌤️ 天気: 晴
💧 湿度: 45%
💨 風速: 12 km/h (SW)
🌡️ 気圧: 1013 mb
👁️ 視程: 10 km
☀️ 紫外線指数: 6
🕐 更新時間: 2024-01-15 14:30

💡 提案:
☀️ 暑い日のため、軽装を着ることをおすすめします
🧴 紫外線が強いので、日焼け止めを塗ることをおすすめします

天気予報の出力例

📍 Beijing, Beijing, China の天気予報

🌟 現在の天気:
温度: 22°C (体感温度: 24°C)
天気: 晴
湿度: 45% | 風速: 12 km/h

📅 これからの予報:
今日 (2024-01-15):
  🌡️ 18°C ~ 25°C | 晴
  💧 湿度: 45% | 🌧️ 降水確率: 10%

明日 (2024-01-16):
  🌡️ 16°C ~ 23°C | 曇り
  💧 湿度: 55% | 🌧️ 降水確率: 20%

🔧 技術詳細

核心コンポーネント

• WeatherService: 天気APIの呼び出しとデータのフォーマット
• LocationService: 地理位置サービスと住所の解析
• MCP Server: 標準MCPプロトコルに基づくサーバーの実装

依存関係

• @modelcontextprotocol/sdk: MCPプロトコルの実装
• axios: HTTPリクエストライブラリ
• zod: データの検証
• dotenv: 環境変数の管理

APIサービスプロバイダー

• Open-Meteo: 無料の天気データプロバイダー
• Open-Meteo Geocoding: 無料の地理コーディングサービス
• IP-API: 無料のIPアドレスの位置特定サービス

🛠️ 開発

プロジェクト構造

weather-mcp-server/
├── src/
│   ├── index.ts              # メインサーバーファイル
│   ├── weather-service.ts    # 天気サービス
│   ├── location-service.ts   # 位置サービス
│   └── types.ts             # 型定義
├── dist/                    # コンパイル出力
├── package.json
├── tsconfig.json
├── env.example
└── README.md

開発コマンド

# 依存関係をインストールする
npm install

# 開発モード（自動再コンパイル）
npm run dev

# コンパイル
npm run build

# 実行
npm start

新機能の追加

1. 対応するサービスクラスに新しいメソッドを追加する
2. src/index.ts で新しいツール、リソース、またはヒントを登録する
3. 必要に応じて型定義を更新する
4. 再コンパイルしてテストする

🔧 トラブルシューティング

一般的な問題

1. ネットワーク接続の問題

   • ネットワーク接続を確認する
   • ファイアウォールの設定が外部APIへのアクセスを許可していることを確認する

2. 住所の解析に失敗した場合

   • より具体的な住所を試す
   • 住所のスペルを確認する

3. コンパイルエラー

   • Node.jsのバージョンが >= 18.0.0であることを確認する
   • node_modules と dist ディレクトリを削除してから再度インストールする

4. サービスが一時的に利用できない場合

   • Open-Meteoサービスがメンテナンス中の可能性があるので、後でもう一度試してください

デバッグモード

詳細なログを有効にするには：

DEBUG=weather-mcp-server npm start

🤝 コントリビューション

コードのコントリビューションを歓迎します！以下の手順に従ってください：

1. プロジェクトをForkする
2. 機能ブランチを作成する (git checkout -b feature/AmazingFeature)
3. 変更をコミットする (git commit -m 'Add some AmazingFeature')
4. ブランチにプッシュする (git push origin feature/AmazingFeature)
5. Pull Requestを作成する

📄 ライセンス

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

💬 サポート

問題が発生した場合や提案がある場合は、以下の手順を行ってください：

1. トラブルシューティングを確認する
2. 既存のIssuesを検索する
3. 新しいIssueを作成し、問題を詳細に説明する

📝 更新履歴

v1.0.0

• 最初のバージョンのリリース
• Open-Meteoの無料APIを使用し、キー不要
• 基本的な天気検索機能をサポート
• 住所と座標による検索をサポート
• 現在位置の自動検出をサポート
• 天気予報（最大16日）をサポート
• スマートな天気提案を提供
• 完全に無料で使用できる

天気MCPサーバーのご利用をお楽しみください！ 🌤️✨