mcp-weather

🚀 MCP 天气

MCP 天气是一个基于模型控制协议（MCP）框架构建的天气信息服务，它能让用户便捷地访问国家气象局（NWS）的数据，为获取实时天气信息提供了高效的解决方案。

🚀 快速开始

MCP 天气是一个 Python 应用程序，作为 MCP 工具运行，可让 AI 助手从国家气象局 API 获取实时天气信息。该服务具备两大核心功能：一是获取任何美国州的活跃天气警报；二是获取特定位置的详细天气预报。

✨ 主要特性

• 可通过 US 状态代码检索活跃天气警报。
• 能获取特定位置的详细天气预报。
• 输出清洁、格式化，便于阅读。
• 作为 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 运行 weather.py

高级用法

如果服务器成功启动且无错误，您可以使用以下命令使工具可用：

PATH/uv --directory 绝对路径/mcp-weather 运行 weather.py

可用工具

获取天气警报

检索指定美国州的活跃天气警报。 | 参数 | 详情 | |------|------| | state | 两个字母的美国州代码（例如 CA、NY） |

获取天气预报

检索特定位置的详细天气预报。 | 参数 | 详情 | |------|------| | latitude | 位置的纬度 | | longitude | 位置的经度 |

📚 详细文档

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

🤝 贡献

欢迎贡献！请随意提交拉取请求。

🙏 致谢

• 国家气象局，感谢提供天气数据 API。
• MCP 框架，感谢支持 AI 工具集成。
• 文档：模型上下文协议