Weather MCP 服务器

这是一个使用美国国家气象局 (NWS) API 提供天气信息的模型上下文协议 (MCP) 服务器。

功能

• 获取美国州的天气警报
• 获取特定位置的天气预报（使用纬度和经度）

要求

• Python 3.10+
• FastMCP
• httpx

安装

1. 克隆此存储库
2. 设置虚拟环境：

   python -m venv .venv
   source .venv/bin/activate  # 在 Windows 上，使用 `.venv\Scripts\activate`
   

3. 使用 uv 安装所需的包：

   uv add "mcp[cli]" httpx
   

配置

服务器使用配置文件 config.py，其中包含以下设置：

• NWS_API_BASE: 美国国家气象局 API 的基本 URL
• USER_AGENT: 向 NWS API 发出请求时使用的 User-Agent 字符串
• LOG_LEVEL: 日志记录级别（例如，“INFO”、“DEBUG”）
• LOG_FORMAT: 日志消息的格式字符串
• REQUEST_TIMEOUT: API 请求的超时时间（以秒为单位）

您可以在 config.py 文件中修改这些设置以自定义服务器行为。

用法

独立运行服务器

要独立运行服务器：

1. 如果尚未激活，请激活虚拟环境：

   source .venv/bin/activate  # 在 Windows 上，使用 `.venv\Scripts\activate`
   

2. 运行服务器：

   python weather.py
   

与 Cline 一起使用

Weather MCP 服务器已添加到 Cline 配置中。 要在 Cline 中使用它：

1. 确保 Cline 已正确设置并正在运行。

2. Weather MCP 服务器将作为名为“weather”的工具提供。

3. 您可以在 Cline 中使用以下工具：

   a. get_alerts(state: str): 获取美国州的天气警报（使用两位数的州代码，例如，加利福尼亚州为“CA”） b. get_forecast(latitude: float, longitude: float): 获取特定位置的天气预报

Cline 中的用法示例：

# 获取加利福尼亚州的警报
result = await mcp.call_tool("weather.get_alerts", state="CA")
print(result)

# 获取旧金山的天气预报（近似坐标）
result = await mcp.call_tool("weather.get_forecast", latitude=37.7749, longitude=-122.4194)
print(result)

注意：调用 MCP 工具的确切语法可能因您的 Cline 设置而异。 有关最新的使用说明，请参阅 Cline 文档。

错误处理和日志记录

服务器包括改进的 API 请求错误处理和日志记录。 如果在请求期间发生错误，服务器将记录该错误并返回相应的错误消息。 日志将使用配置的日志级别和格式打印到控制台。

测试

单元测试

要运行单元测试：

python -m unittest test_weather.py

这些测试涵盖了 get_alerts 和 get_forecast 工具的基本功能。

手动测试

要手动测试服务器，您可以使用 MCP 客户端调用提供的工具。 以下是一些示例命令：

# 获取加利福尼亚州的警报
result = await mcp.call_tool("get_alerts", state="CA")
print(result)

# 获取旧金山的天气预报（近似坐标）
result = await mcp.call_tool("get_forecast", latitude=37.7749, longitude=-122.4194)
print(result)

贡献

欢迎贡献！ 请随时提交 Pull Request。

许可证

本项目是开源的，并根据 MIT 许可证 提供。