KNMI 天气 MCP

一个 FastMCP 服务器，提供来自 KNMI (荷兰皇家气象研究所) 气象站的实时天气数据。此应用程序从荷兰境内任何位置最近的气象站获取最新的 10 分钟测量数据。

<a href="https://glama.ai/mcp/servers/xanerdcjsm"> <img width="380" height="200" src="https://glama.ai/mcp/servers/xanerdcjsm/badge" alt="KNMI Weather MCP server" /> </a>

功能特性

• 获取荷兰境内任何位置的天气数据
• 自动查找最近的 KNMI 气象站
• 提供实时测量数据，包括：
  • 温度
  • 湿度
  • 风速和风向
  • 降水
  • 能见度
  • 气压
• 天气状况的自然语言解释
• 位置搜索功能
• 详细的日志记录

前提条件

• Python 3.10 或更高版本
• KNMI API 密钥 (从 KNMI Data Platform 获取)
• 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 Weather": {
      "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 Data Platform API 从 "Actuele10mindataKNMIstations" 数据集中获取数据，该数据集提供来自荷兰所有 KNMI 气象站的 10 分钟间隔测量数据。

错误处理

该应用程序包括强大的错误处理功能，用于处理：

• 无效位置
• API 身份验证问题
• 网络问题
• 数据解析错误
• 缺少测量数据