AI导哈

天气数据服务

一个基于OpenWeatherMap API的天气数据服务，提供实时天气、5天天气预报、空气质量数据和位置搜索功能。

  • by jalaj-pandey
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 jalaj-pandey/weather-mcp-tool

使用说明

气象MCP工具（以印度为重点）

使用OpenWeatherMap API的MCP（模型上下文协议）服务器提供：

  • 实时天气状况
  • 五天天气预报
  • 空气质量数据
  • 位置搜索

🚀 设置

  1. Python 3.10+ 是必需的。
  2. 安装依赖项：
    pip install -r requirements.txt
  3. 获取API密钥 从 OpenWeatherMap.
  4. 创建一个 .env 文件 在根文件夹中：
    OPENWEATHER_API_KEY=your_api_key_here

🛠 可用工具

get_current_weather(location: str)

返回给定位置的当前天气。

get_weather_forecast(location: str, days: int = 5)

返回该位置的天气预报（最多5天）。

get_air_quality(location: str)

返回空气质量指标和空气质量指数水平。

search_location(query: str)

根据查询返回最多5个位置匹配。

🧪 输出示例（印度）

当前天气（德里）

{
  "location": {
    "name": "Delhi",
    "country": "IN",
    "lat": 28.6139,
    "lon": 77.2090
  },
  "temperature": {
    "current": 32.4,
    "feels_like": 35.1,
    "min": 30.0,
    "max": 36.2
  },
  "weather_condition": {
    "main": "Haze",
    "description": "smoky haze",
    "icon": "50d"
  },
  "wind": {
    "speed": 4.1,
    "deg": 135
  },
  "clouds": 20,
  "humidity": 58,
  "pressure": 1005,
  "visibility": 5000,
  "sunrise": "2025-03-16T06:20:00",
  "sunset": "2025-03-16T18:40:00",
  "timestamp": "2025-03-16T14:30:00"
}

天气预报（孟买）

{
  "location": {
    "name": "Mumbai",
    "country": "IN",
    "lat": 19.0760,
    "lon": 72.8777
  },
  "forecast": [
    {
      "datetime": "2025-03-16T12:00:00",
      "temperature": {
        "temp": 33.2,
        "feels_like": 37.8,
        "min": 31.5,
        "max": 34.0
      },
      "weather_condition": {
        "main": "Clouds",
        "description": "scattered clouds",
        "icon": "03d"
      },
      "wind": {
        "speed": 3.9,
        "deg": 200
      },
      "clouds": 40,
      "humidity": 70,
      "pressure": 1008,
      "visibility": 10000,
      "pop": 0.1
    }
  ],
  "days": 5
}

空气质量（班加罗尔）

{
  "location": {
    "name": "Bengaluru",
    "country": "IN",
    "lat": 12.9716,
    "lon": 77.5946
  },
  "air_quality_index": 2,
  "air_quality_level": "Fair",
  "components": {
    "co": 102.4,
    "no": 0.0,
    "no2": 12.6,
    "o3": 30.5,
    "so2": 3.8,
    "pm2_5": 45.1,
    "pm10": 60.2,
    "nh3": 1.5
  },
  "timestamp": "2025-03-16T14:30:00"
}

位置搜索

{
  "results": [
    {
      "name": "Kolkata",
      "state": "West Bengal",
      "country": "IN",
      "lat": 22.5726,
      "lon": 88.3639
    },
    {
      "name": "Kolkata",
      "state": "",
      "country": "IN",
      "lat": 22.5675,
      "lon": 88.3700
    }
  ]
}

🧰 错误处理

所有工具都返回明确的错误消息：

{ "error": "Location 'XYZ' not found" }

📌 备注

  • 确保 .env 文件配置正确。
  • API密钥可能需要一段时间才能激活。
  • OpenWeatherMap免费层：每分钟60个API调用。

🧑‍💻 Run the Server

mcp dev main.py

运行后，您可以将此服务器与MCP兼容的客户端（如Claude Desktop或其他自动化工具）一起使用。

相关 MCP