关键词

天气预报天气预警美国国家气象局NWS工具智能体

使用说明

项目简介

本项目 'weather-MCP-server1' 是一个简单的 MCP 服务器实现，专注于提供天气信息。它通过定义和注册工具，允许LLM客户端查询美国国家气象局 (NWS) 的实时天气预警和天气预报数据。该服务器使用 Python 和 'fastmcp' 库构建，易于部署和使用。

主要功能点

  • 获取天气预警 (get_alerts): 根据美国州份代码，查询并返回该州当前生效的天气预警信息，包括事件类型、影响区域、严重程度、详细描述和指导说明。
  • 获取天气预报 (get_forecast): 根据经纬度坐标，查询并返回未来一段时间内的天气预报，包括温度、风速风向和详细预报描述。服务器默认返回未来5个时间段的预报。

安装步骤

  1. 环境准备: 确保已安装 Python 3.8 或更高版本。
  2. 安装依赖: 使用 pip 安装项目依赖 'mcp-server' 和 'httpx'。在终端中执行以下命令： 
    pip install mcp-server httpx
  3. 保存代码: 将 'weather.py' 文件保存到本地。

服务器配置

为了让 MCP 客户端能够连接到此天气信息服务器，需要提供以下服务器配置信息。客户端需要配置 server name、command 和 args 以启动服务器进程。

{
  "server_name": "weather",
  "command": "python",
  "args": ["weather.py"]
}

配置参数说明:

  • 'server_name': 服务器名称，这里设置为 "weather"，与 'weather.py' 代码中 'FastMCP("weather")' 初始化时定义的名称一致。
  • 'command': 启动服务器的命令，由于服务器是 Python 脚本，因此使用 'python' 命令来执行。
  • 'args': 命令参数，指定要执行的 Python 脚本文件，这里是 'weather.py'。

注意: MCP 客户端需要能够找到 'weather.py' 文件，建议在客户端配置中指定 'weather.py' 文件的绝对路径，或者在与客户端相同的目录下运行服务器。

基本使用方法

  1. 启动服务器: MCP 客户端根据上述服务器配置，通过 'python weather.py' 命令启动天气信息 MCP 服务器。服务器将通过标准输入/输出 (stdio) 与客户端进行通信。

  2. 客户端调用工具: 客户端可以使用 MCP 协议向服务器发送 JSON-RPC 请求，调用已注册的工具。

    • 调用 'get_alerts' 工具示例 (假设州份代码为 "CA"): 客户端发送请求调用 'get_alerts' 工具，并传入参数 '{"state": "CA"}'。服务器将返回加州的天气预警信息。

    • 调用 'get_forecast' 工具示例 (假设经纬度为 34.0522, -118.2437): 客户端发送请求调用 'get_forecast' 工具，并传入参数 '{"latitude": 34.0522, "longitude": -118.2437}'。服务器将返回该位置的天气预报信息。

  3. 接收响应: 服务器会将工具执行结果封装成 JSON-RPC 响应返回给客户端。客户端解析响应即可获取天气信息。

提示: 本服务器仅实现了工具功能，没有资源和 Prompt 模板的示例。实际应用中可以根据 MCP 的定义扩展资源和 Prompt 模板功能。

信息

分类

网页与API

访问项目