Knmi MCP

🚀 KNMI 天気 MCP サーバー

このアプリケーションは、オランダ皇家気象研究所（KNMI）の気象観測所から、最新の10分間の測定データを取得し、任意の場所のリアルタイムな天気データを提供する高速なMCPサーバーです。

✨ 主な機能

• オランダの任意の場所の天気データを取得
• 自動的に最寄りのKNMI気象観測所を検索
• 以下のリアルタイム測定データを提供：
  • 温度
  • 湿度
  • 風速と風向
  • 降水量
  • 視程
  • 大気圧
• 天気状況の自然言語による解説
• 場所検索機能
• 詳細なログ記録

📦 インストール

前提条件

• Python 3.10以上
• KNMI APIキー（KNMI データプラットフォームから取得）
• uv パッケージマネージャー

インストール手順

1. リポジトリをクローンします：

git clone <repository-url>
cd knmi-mcp

2. プロジェクトのルートディレクトリに .env ファイルを作成します：

KNMI_API_KEY=your_api_key_here

🚀 クイックスタート

Claude AIを使用する場合

このアプリケーションをClaude AIと一緒に実行するには、プロジェクトフォルダで以下のコマンドを実行します：

uv run fastmcp install src/knmi_weather_mcp/server.py

これにより、Claudeの設定ファイル（通常は ~/Library/Application Support/Claude/claude_desktop_config.json）に以下の設定が追加されます：

{
    "KNMI 天気": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "httpx",
        "--with",
        "netCDF4",
        "--with",
        "numpy",
        "--with",
        "pandas",
        "--with",
        "pydantic",
        "--with",
        "python-dotenv",
        "--with",
        "xarray",
        "fastmcp",
        "run",
        "/Users/<username>/<git location>/knmi-mcp/src/knmi_weather_mcp/server.py"
      ]
    }
}

注意：以下のエラーが発生した場合：

spawn uv ENOENT

uv コマンドを uv の完全パスに置き換えてください。*nixシステムでは、which uv コマンドで見つけることができます。

手動で実行する場合

開発または独立して使用するためには、以下のコマンドを実行します：

uv run fastmcp run src/knmi_weather_mcp/server.py

💻 使用例

基本的な使用法

1. what_is_the_weather_like_in

任意の場所の現在の天気状況を自然言語で解説する情報を取得します。

await what_is_the_weather_like_in("Amsterdam")

2. get_location_weather

ある場所の生の天気データを取得します。

await get_location_weather("Rotterdam")

3. search_location

オランダの場所を検索します。

await search_location("Utrecht")

4. get_nearest_station

指定された座標の近くのKNMI気象観測所を検索します。

await get_nearest_station(52.3676, 4.9041)

📚 ドキュメント

ログ記録

アプリケーションのログは logs/knmi_weather.log ファイルに保存され、以下の情報が詳細に記録されます：

• APIリクエストとレスポンス
• 天気データの処理
• エラーメッセージ
• デバッグ情報

データソース

このアプリケーションは、KNMIデータプラットフォームAPIを使用して、「Actuele10mindataKNMIstations」データセットからデータを取得します。このデータセットは、オランダのすべてのKNMI気象観測所の10分間隔の測定値を提供します。

エラー処理

このアプリケーションには強力なエラー処理機能が備わっており、以下の状況を処理することができます：

• APIキーが設定されていないまたは無効である
• KNMIサーバーに接続できない
• データ解析に失敗する
• ネットワーク問題