Skip to main content
Glama
Weather MCP Server

Weather MCP Server

天气 MCP 服务器

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

功能

此服务器公开了允许 AI 助手获取实时天气数据的工具:

  • get_alerts(state: str):获取指定美国州(使用 2 字母州代码,如 CA、NY、TX)的有效天气警报。返回有关事件、严重程度、描述和安全说明的详细信息。

  • get_forecast(latitude: float, longitude: float):获取特定位置(使用纬度和经度)的详细天气预报。返回未来 5 个时段的预报(例如:今天下午、今晚、明天)。

Related MCP server: weather-mcp

先决条件

  • Python 3.10 或更高版本

  • uv 包管理器

安装与设置

本项目使用 uv 进行依赖管理。设置步骤如下:

  1. 克隆仓库

  2. 安装依赖(如果使用 uv 运行,这将创建一个虚拟环境):

    uv sync

使用方法

你可以通过标准输入/输出手动运行 MCP 服务器,这也是 MCP 客户端与其交互的方式:

uv run weather.py

与 Claude Desktop 集成

要将此服务器与 Claude Desktop 一起使用,请将其添加到你的 claude_desktop_config.json 中:

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/your/mcp-server",
        "run",
        "weather.py"
      ]
    }
  }
}

与自定义 MCP 客户端集成

如果你有自定义的 Python MCP 客户端,可以按如下方式连接:

from mcp import StdioServerParameters

server_params = StdioServerParameters(
    command="uv",
    args=["--directory", "path/to/mcp-server", "run", "weather.py"],
    env=None
)
# Pass server_params to your MCP client

使用的 API

Available Tools

2 tools
get_alertsA

Get weather alerts for a US state.

Args: state: Two-letter US state code (e.g. CA, NY)

Inputs: state (required). Returns: result

get_forecastC

Get weather forecast for a location.

Args: latitude: Latitude of the location longitude: Longitude of the location

Inputs: latitude (required), longitude (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    get_alerts and get_forecast have clearly distinct purposes: one for weather alerts by state, the other for forecast by coordinates. No overlap exists.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern (get_alerts, get_forecast), making them predictable.

    Tool Count3/5

    With only 2 tools, the server feels thin for a weather domain, bordering on insufficient scope.

    Completeness2/5

    Common weather operations like current conditions, hourly forecast, or radar are missing, leaving significant gaps for typical use cases.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers