天气CLI应用

一个简单的应用程序,用于从国家气象服务API获取天气警报和预报,使用模型上下文协议(MCP)。

  • by aryankarn
  • PowerShell
  • 本地部署
  • 更新于
在 GitHub 查看 aryankarn/weather-mcp-server

使用说明

天气CLI应用程序

一个简单的应用程序,使用模型上下文协议(MCP)从美国国家气象局API获取天气警报和预报。

特性

  • 获取美国任何州的活跃天气警报
  • 按坐标获取任何位置的天气预报
  • 用于与AI助手集成的MCP服务器实现

安装

  1. 确保您安装了Python 3.11或更高版本
  2. 克隆此存储库
  3. 使用pip安装软件包:
# Install with pip
pip install -e .

# Or if you have pip3 specifically
pip3 install -e .

备注:本项目使用MCP框架,不需要 uv 具体来说,无论锁文件可能暗示什么。

用作MCP服务器

安装后,支持模型上下文协议的AI助手可以访问天气MCP服务器。服务器提供两个主要工具:

  1. get_alerts -获取美国某个州的天气警报(使用两个字母的州代码)
  2. get_forecast -获取特定坐标(纬度、经度)的天气预报

发展

本项目使用:

  • httpx用于异步HTTP请求
  • 用于结构化数据处理的MCP服务器工具

故障排除

如果您看到以下错误 spawn uv ENOENT 在日志中:

  1. 确保您已使用pip而不是uv安装了该软件包
  2. 检查你的Python环境是否配置正确
  3. 尝试手动运行服务器以查看任何其他stderr输出: python -m weather

api信息

此应用程序使用美国国家气象局(NWS)API检索天气数据。不需要API密钥,但请遵守他们的费率限制。