关键词

天气预报天气警报OpenWeatherMaplocation气象服务

使用说明

项目简介

本项目 'Weather Alerts & Forecasts' 是一个基于 Model Context Protocol (MCP) 构建的天气信息服务器。它利用 OpenWeatherMap API 提供实时的天气警报和天气预报服务，并以 MCP 协议标准化的方式与 LLM 客户端进行交互。

主要功能点

  • 获取天气警报 (get_alerts): 根据美国州份代码，检索并返回该地区主要城市的天气警报信息，例如极端高温、冰冻天气、雷暴等。
  • 获取天气预报 (get_forecast): 根据经纬度坐标，检索并返回未来几个时间段的天气预报信息，包括温度、体感温度、天气状况、湿度和风速等。

安装步骤

  1. 安装 Python 依赖: 确保你的 Python 环境中安装了必要的库。建议使用 pip 进行安装：

    pip install python-dotenv httpx mcp-server

    请注意，'mcp-server' 是 MCP 服务器框架，如果尚未安装，请先安装。

  2. 配置 OpenWeatherMap API 密钥: 本项目需要使用 OpenWeatherMap API 获取天气数据。

    • 访问 OpenWeatherMap 官网 注册并获取 API 密钥。
    • 在项目根目录下创建 '.env' 文件，并添加你的 API 密钥，例如： 
      OWM_API_KEY=你的_API_密钥

服务器配置

MCP 客户端需要以下配置信息来连接到此天气服务器。请将以下 JSON 配置添加到你的 MCP 客户端配置中：

{
  "serverName": "weather-server",
  "command": "python",
  "args": ["weather.py"],
  "transport": "stdio"
}

配置参数说明:

  • 'serverName': 服务器名称，可以自定义，例如 "weather-server"。
  • 'command': 启动服务器的命令，这里使用 'python' 解释器。
  • 'args': 命令参数，指定要运行的服务器脚本为 'weather.py'。
  • 'transport': 传输协议，这里使用 'stdio' 标准输入输出流。

基本使用方法

  1. 启动服务器: 在安装好依赖并配置 API 密钥后，通过 MCP 客户端启动配置中指定的命令 ('python weather.py') 来运行天气服务器。

  2. 客户端调用工具: 在 MCP 客户端中，你可以调用以下工具来获取天气信息：

    • 'get_alerts' 工具: 用于获取天气警报。你需要提供州份代码作为参数，例如 '{"tool_call_id": "get_alerts_1", "type": "function", "function": {"name": "get_alerts", "arguments": "{"state": "CA"}"}}' 来获取加利福尼亚州的天气警报。
    • 'get_forecast' 工具: 用于获取天气预报。你需要提供经纬度坐标作为参数，例如 '{"tool_call_id": "get_forecast_1", "type": "function", "function": {"name": "get_forecast", "arguments": "{"latitude": 34.0522, "longitude": -118.2437}"}}' 来获取洛杉矶的天气预报。

    客户端会向服务器发送符合 MCP 协议的 JSON-RPC 请求，服务器处理请求后返回 JSON-RPC 响应。

通过以上步骤，你就可以使用 'Weather Alerts & Forecasts' MCP 服务器为你的 LLM 应用提供实时的天气信息服务了。

信息

分类

网页与API

访问项目