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

可用工具

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服务器
• 数据解析失败
• 网络问题