Weather MCP Server

Weather MCP Server

一个基于模型上下文协议（MCP）的服务器，通过美国国家气象局（NWS）API 提供天气信息和预警。

功能

• 获取美国任意州的天气预警
• 使用纬度和经度获取任意地点的详细天气预报
• 易于使用的 MCP 接口
• 支持 Docker，便于部署

前提条件

• Python 3.13 或更高版本
• Docker 和 Docker Compose（用于容器化部署）

安装

本地开发

1. 克隆仓库
2. 使用 uv 安装依赖：

   pip install uv
   uv venv
   uv pip install .
   uv run src/main.py
   

Docker 部署

使用 Docker Compose 构建并运行服务器即可：

docker compose up -d

服务器端点将在 http://localhost:8001/sse 提供。

可用工具

get_alerts(state: str)

获取美国某个州当前生效的天气预警。

参数：

• state：美国州的两字母代码（例如，加利福尼亚州为 "CA"，纽约州为 "NY"）

get_forecast(latitude: float, longitude: float)

获取特定地点的详细天气预报。

参数：

• latitude：地点的纬度
• longitude：地点的经度

开发

项目使用 Docker 卷进行开发，无需重新构建容器即可反映代码更改。源代码挂载在容器中的 /app/src。

技术详情

• 使用 Python 的 MCP 框架构建
• 使用 httpx 发送异步 HTTP 请求
• 实现完善的错误处理和请求超时
• 使用 uv 管理依赖
• 使用 Docker 容器化，便于部署

环境变量

• PYTHONUNBUFFERED=1：确保 Python 输出不经缓冲，直接发送到终端

端口

服务器在容器内运行于端口 8000，并映射到主机上的端口 8001。