项目简介

本项目实现了一个基于 Model Context Protocol (MCP) 的服务器,专注于提供天气信息服务。它通过注册工具的方式,允许LLM客户端调用来获取美国国家气象局 (NWS) 的实时天气预警和天气预报数据。

主要功能点

  • 获取天气预警 (get_alerts): 根据美国州份代码,检索并返回该地区当前生效的天气警报信息。
  • 获取天气预报 (get_forecast): 根据经纬度坐标,检索并返回未来几天的详细天气预报信息。

安装步骤

  1. 环境准备: 确保您的系统已安装 Python 环境。
  2. 安装依赖: 使用 pip 安装 'httpx' 库,该库用于进行网络请求。在命令行中执行:
    pip install httpx
  3. 运行服务器: 直接运行 'weather.py' 文件即可启动 MCP 服务器。

服务器配置

为了使 MCP 客户端能够连接到此服务器,您需要提供以下配置信息。这些信息通常配置在 MCP 客户端的应用设置中。

{
  "server_name": "weather",  // 服务器名称,可以自定义,用于在客户端标识服务器
  "command": "python",      // 启动服务器的命令,这里使用 python 解释器
  "args": ["weather.py"]   // 启动命令的参数,指定要运行的 weather.py 文件
}

配置说明:

  • 'server_name': 为您的服务器指定一个易于识别的名称。
  • 'command': 指定启动服务器程序的可执行命令。由于 'weather.py' 是 Python 脚本,所以这里使用 'python'。
  • 'args': 一个字符串数组,包含传递给启动命令的参数。这里指定了要运行的 Python 脚本文件名 'weather.py'。

基本使用方法

  1. 启动服务器: 在安装并配置完成后,首先需要运行 'weather.py' 文件来启动 MCP 服务器。
  2. 客户端连接: 配置您的 MCP 客户端,使其能够连接到正在运行的 MCP 服务器。客户端需要使用上面提供的服务器配置信息。
  3. 调用工具: 客户端连接成功后,即可通过 MCP 协议调用服务器提供的工具,例如:
    • 调用 'get_alerts' 工具并提供州份代码 (如 "CA"),即可获取加利福尼亚州的天气预警信息。
    • 调用 'get_forecast' 工具并提供经纬度坐标,即可获取指定位置的天气预报信息。

请参考 MCP 客户端的文档,了解如何配置服务器连接以及如何调用服务器提供的工具。

信息

分类

网页与API