项目简介
本项目实现了一个基于 Model Context Protocol (MCP) 的服务器,专注于提供天气信息服务。它通过注册工具的方式,允许LLM客户端调用来获取美国国家气象局 (NWS) 的实时天气预警和天气预报数据。
主要功能点
- 获取天气预警 (get_alerts): 根据美国州份代码,检索并返回该地区当前生效的天气警报信息。
- 获取天气预报 (get_forecast): 根据经纬度坐标,检索并返回未来几天的详细天气预报信息。
安装步骤
- 环境准备: 确保您的系统已安装 Python 环境。
- 安装依赖: 使用 pip 安装 'httpx' 库,该库用于进行网络请求。在命令行中执行:
pip install httpx - 运行服务器: 直接运行 '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'。
基本使用方法
- 启动服务器: 在安装并配置完成后,首先需要运行 'weather.py' 文件来启动 MCP 服务器。
- 客户端连接: 配置您的 MCP 客户端,使其能够连接到正在运行的 MCP 服务器。客户端需要使用上面提供的服务器配置信息。
- 调用工具: 客户端连接成功后,即可通过 MCP 协议调用服务器提供的工具,例如:
- 调用 'get_alerts' 工具并提供州份代码 (如 "CA"),即可获取加利福尼亚州的天气预警信息。
- 调用 'get_forecast' 工具并提供经纬度坐标,即可获取指定位置的天气预报信息。
请参考 MCP 客户端的文档,了解如何配置服务器连接以及如何调用服务器提供的工具。
信息
分类
网页与API