关键词

天气预报天气警报NWS APIPythonFastMCP

使用说明

项目简介

本项目是一个基于 Python FastMCP 库构建的 MCP 服务器模板，旨在演示如何快速搭建一个提供工具服务的 MCP 服务器。该模板实现了一个简单的天气服务，通过调用美国国家气象局 (NWS) 的 API，提供指定地区的天气预报和天气警报查询功能。

主要功能点

  • 天气预报查询 (get_forecast): 根据经纬度获取未来几天的详细天气预报，包括温度、风速、风向和天气描述。
  • 天气警报查询 (get_alerts): 查询美国特定州当前生效的天气警报信息，包括事件类型、影响区域、严重程度、描述和指令。
  • FastMCP 框架: 使用 FastMCP 库简化 MCP 服务器的开发，自动处理 MCP 协议的细节。
  • 标准 JSON-RPC 通信: 通过标准输入输出 (stdio) 与 MCP 客户端进行 JSON-RPC 协议通信。

安装步骤

  1. 安装 Python: 确保您的系统已安装 Python 3.7 或更高版本。
  2. 获取代码: 从 GitHub 仓库下载或克隆 'model-context-protocol-templates' 仓库到本地。
  3. 进入目录: 使用终端或命令提示符，导航到 'templates/Python/servers/weather' 目录。
  4. 安装依赖: 运行以下命令安装项目依赖的 Python 库 (fastmcp 和 httpx)： 
    pip install fastmcp httpx

服务器配置

要让 MCP 客户端连接到此天气服务器，您需要在客户端配置服务器的启动信息。以下是一个 JSON 格式的配置示例，您需要将其添加到您的 MCP 客户端配置中：

{
  "serverName": "weather",
  "command": "python",
  "args": ["weather.py"]
}
  • 'serverName': 服务器名称，可以自定义，例如 "weather"。
  • 'command': 启动服务器的命令，这里是 'python'，假设您的 Python 解释器在 PATH 环境变量中。
  • 'args': 命令参数，这里指定运行 'weather.py' 文件。

基本使用方法

  1. 启动服务器: 在 MCP 客户端中配置好服务器信息后，启动该天气服务器。客户端通常会自动运行配置的命令来启动服务器。
  2. 调用工具: 在您的 LLM 应用中，通过 MCP 客户端向 "weather" 服务器发送请求，调用 'get_forecast' 或 'get_alerts' 工具，并传递相应的参数。
    • 例如，调用 'get_forecast' 工具时，需要提供 'latitude'（纬度）和 'longitude'（经度）参数。
    • 调用 'get_alerts' 工具时，需要提供 'state'（美国州份的两位代码，例如 "CA" 代表加利福尼亚州）参数。
  3. 接收响应: 服务器会将天气预报或警报信息以字符串形式返回给客户端，您的 LLM 应用可以利用这些信息生成更丰富的回复。

信息

分类

网页与API

访问项目