Weather MCP

一个 FastMCP 服务器，从 Open-Meteo 获取天气数据，并通过 MCP Apps 渲染交互式天气仪表盘。

功能

• 按城市或地名搜索位置

• 获取当前天气状况和最多 16 天的预报

• 在摄氏度和华氏度之间切换

• 显示天气描述和天气状况符号

• 将位置和预报响应缓存五分钟

• 在兼容的 MCP 主机中直接渲染仪表盘

Related MCP server: bridgemcp-server-weather

要求

• Python 3.14+

• uv

• 支持 MCP Apps 的 MCP 主机，用于交互式仪表盘

设置

安装项目依赖：

uv sync

正常的非商业 Open-Meteo 使用无需天气 API 密钥。

运行服务器

通过默认的 stdio 传输方式运行服务器：

uv run python main.py

查看已注册的工具：

uv run fastmcp list main.py

预览仪表盘

FastMCP 包含用于应用工具的本地浏览器预览：

uv run fastmcp dev apps main.py

打开显示的本地 URL 并选择 weather_dashboard。该仪表盘支持搜索其他位置和切换温度单位。

MCP 工具

search_locations

查找匹配的位置，并返回其坐标、国家、地区和时区。

get_weather

获取某个位置的当前天气和每日预报。

参数：

• location：城市或地名

• forecast_days：预报天数，从 1 到 16

• temperature_unit：celsius 或 fahrenheit

weather_dashboard

使用相同的天气参数打开交互式天气仪表盘。

项目结构

main.py                         MCP server entry point
src/tools.py                    MCP tool registration and response shaping
src/services/weather_service.py Open-Meteo client and response cache
src/formatting.py               UI-friendly forecast formatting
src/dashboard.py                Prefab MCP App UI

数据来源

天气数据由 Open-Meteo 提供，它整合了多个国家气象服务机构的预报。在商业部署之前，请查看 Open-Meteo 条款和许可。