天气信息服务

基于MCP框架的天气信息服务,提供美国国家气象局(NWS)的实时天气警报和天气预报数据,适用于AI助手集成。

  • by jpan8866
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 jpan8866/mcp-weather

使用说明

MCP天气

一种基于模型控制协议(MCP)框架构建的天气信息服务,提供对国家气象局(NWS)数据的访问。

概述

MCP Weather是一个Python应用程序,用作MCP工具,允许人工智能助手从美国国家气象局API访问实时天气信息。该服务提供两个主要功能:

  1. 天气警报:获取美国任何州的活跃天气警报
  2. 天气预报:按纬度和经度获取美国任何地点的详细天气预报

特性

  • 按美国州代码检索当前天气警报
  • 获取特定地点的详细天气预报
  • 干净、格式化的输出,便于阅读
  • 作为MCP工具构建,可与AI助手无缝集成

需求

  • Python 3.13或更高版本
  • 依赖关系:
    • httpx
    • mcp[cli]

安装

  1. 克隆此存储库:
    git clone https://github.com/jpan8866/mcp-weather.git
    cd mcp-weather
    
  2. 您将需要python包管理器 uv 运行服务器
    curl -LsSf https://astral.sh/uv/install.sh | sh
    

用法

作为MCP服务运行

要测试服务器,请运行

uv run weather.py

如果服务器成功运行且没有错误,您可以使用以下命令使该工具可用:

PATH/uv --directory ABSOLUTE_PATH/mcp-weather run weather.py

可用工具

获取天气警报

检索指定美国州的活动天气警报。

参数:

  • state:两个字母的美国州代码(例如,加利福尼亚州、纽约州)

获取天气预报

检索特定位置的详细天气预报。

参数:

  • latitude:位置纬度
  • longitude:位置经度

api参考

应用程序使用 美国国家气象局API 以获取天气数据。

贡献

欢迎投稿!请随时提交拉取请求。

致谢

  • 美国国家气象局提供天气数据API
  • 用于实现AI工具集成的MCP框架
  • 模型上下文协议文档:https://modelcontextprotocol.io/quickstart/server#test-使用命令