Knmi MCP

🚀 KNMI 天氣 MCP 服務器

這是一個快速的MCP服務器，可提供荷蘭皇家氣象研究所（KNMI）氣象站的即時天氣數據。它能從最近的KNMI氣象站獲取任何位置的最新10分鐘測量數據，為用戶帶來便捷的天氣信息服務。

🚀 快速開始

本服務器可快速獲取荷蘭任何位置的即時天氣數據，通過簡單的配置和操作即可投入使用。

✨ 主要特性

• 廣泛的數據覆蓋：可獲取荷蘭任何位置的天氣數據。
• 智能站點查找：自動查找最近的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

可用工具

基礎用法

• 獲取天氣自然語言解釋：

await what_is_the_weather_like_in("Amsterdam")

• 獲取原始天氣數據：

await get_location_weather("Rotterdam")

• 搜索地點：

await search_location("Utrecht")

• 查找最近氣象站：

await get_nearest_station(52.3676, 4.9041)

📚 詳細文檔

日誌記錄

應用程序日誌存儲在 logs/knmi_weather.log 文件中，提供有關 API 請求和響應、天氣數據處理、錯誤消息、調試信息等方面的詳細信息。

數據來源

此應用程序使用 KNMI 數據平臺 API 從“Actuele10mindataKNMIstations”數據集獲取數據，該數據集提供荷蘭所有 KNMI 氣象站的 10 分鐘間隔測量值。

錯誤處理

該應用程序包括強大的錯誤處理功能，能夠處理 API 密鑰未設置或無效、無法連接到 KNMI 服務器、數據解析失敗、網絡問題等情況。