MCP-Weather-Server

🚀 天气 MCP 服务器

本项目是一个 MCP（模型上下文协议）服务器，用于访问美国国家气象局（NWS）API 的 US 天气数据。它提供了便捷的工具，可获取任意美国州份的天气警报与预测。

🚀 快速开始

此服务器通过标准输入输出运行，以确保与 MCP 客户端的兼容性。运行服务器的命令如下：

python weather.py

✨ 主要特性

• 可依据两个字母的州代码，获取任意美国州的天气警报。
• 借助纬度和经度，获取详细的天气预报。
• 具备结构化日志记录功能，附带上下文信息。
• 支持错误处理和超时管理。

📦 安装指南

通过 Smithery 安装

若要借助 Smithery 自动将 mcp-weather-server 安装到 Claude Desktop，可使用以下命令：

npx -y @smithery/cli install @asifdotpy/mcp-weather-server --client claude

手动安装

# 克隆仓库
git clone <repository-url>

# 进入目录
cd weather

# 安装依赖项（需要 Python 3.11+）
pip install -e .

📚 详细文档

依赖

• httpx：用于进行异步 HTTP 请求。
• mcp：构建 MCP 服务器的模型上下文协议库。

使用方法

该服务器提供了两个主要工具：

获取天气警报

get_alerts(state: str) -> str

• state：美国州代码，两个字母（例如 CA、NY）。
• 返回指定州的格式化天气警报信息。

获取天气预报

get_forecast(latitude: float, longitude: float) -> str

• latitude：位置纬度。
• longitude：位置经度。
• 返回指定坐标点的 5 时段天气预报。

开发

• 设置 ENV 环境变量为 "production" 以获得 JSON 格式的日志。
• 使用 LOG_LEVEL 环境变量配置日志级别。

📄 许可证

[在此处指定你的许可证信息]