天气数据服务

一个基于MCP协议的天气数据服务,提供美国各州的天气警报和特定地点的详细天气预报。

  • by Zachwitte21
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Zachwitte21/weather-mcp

使用说明

天气MCP服务器

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

特点/功能

这个MCP服务器提供了两种工具来访问天气数据:

  • **get_alerts**获取美国任何州的实时天气警报
  • **get_forecast**获取特定位置(纬度/经度)的详细天气预报

要求

  • Python >= 3.14(注:这里的“>=”表示“大于或等于”,在中文语境下,我们通常会说“Python版本需大于或等于3.14”,但直接翻译时保持符号不变以体现原文的精确含义。)
  • uv(推荐用于依赖管理)

设置

  1. 克隆此仓库或下载源代码

  2. 使用 uv 安装依赖项:

uv sync

运行服务器

服务器使用stdio传输方式进行MCP通信:

uv run weather.py

与MCP客户端一起使用

要使用此服务器与MCP客户端(如Claude Desktop)配合,需将其添加到您的MCP客户端配置中:

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "c:\\Users\\Zachary\\Dev\\weather",
        "run",
        "weather.py"
      ]
    }
  }
}

可用工具

获取警报

获取美国某州的实时天气警报。

参数:

  • state (字符串):美国两字母州代码(例如,“CA”,“NY”,“TX”)

示例:

get_alerts(state="CA")

获取天气预报

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

参数:

  • latitude (浮点数):该位置的纬度
  • longitude (float): 位置的经度

示例:

get_forecast(latitude=37.7749, longitude=-122.4194)

数据源

这台服务器使用的是 国家气象局API该网站为美国各地提供免费的天气数据。

许可证

在此添加您的许可证信息。