使用说明

项目简介

Weather MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，它利用美国国家气象局 (NWS) API 提供实时的天气预警和天气预报服务。通过 MCP 协议，此服务器可以作为 LLM 客户端（如 Claude）的外部工具，扩展其在天气信息方面的能力，使得 LLM 能够根据用户指令调用工具获取最新的天气信息。

主要功能点

获取天气预警：根据美国州份（例如 CA, NY）查询当前生效的天气灾害预警信息，例如暴雨、高温、雷暴等。
获取天气预报：根据经纬度坐标查询特定地点的详细天气预报，包括温度、风速、风向以及详细的天气描述。

安装步骤

安装 Python: 确保您的计算机上已安装 Python 3.12 或更高版本。您可以从 Python 官网下载并安装。
安装依赖: 打开命令行终端，导航到您下载的 'Weather-MCP' 仓库目录中，运行以下命令安装项目依赖：
```
uv pip install .
```
请确保您已安装 'uv' 包管理器。如果未安装，请先使用 'pip install uv' 安装。
下载 Claude Desktop app: 此 MCP 服务器设计用于与 Claude Desktop app 协同工作。请确保您已下载并安装 Claude Desktop app。

服务器配置

要将 Weather MCP Server 集成到 Claude Desktop app 中，您需要修改 Claude 的配置文件。

找到配置文件: 配置文件的路径通常为 'C:\Users\您的用户名\AppData\Roaming\Claude\claude_desktop_config.json'。请将 “您的用户名” 替换为您的实际用户名。
编辑配置文件: 使用文本编辑器打开 'claude_desktop_config.json' 文件。在 JSON 对象的 'servers' 数组中添加一个新的服务器配置。如果 'servers' 数组不存在，请创建它。
```
{
  "servers": [
    {
      "serverName": "weather-mcp",
      "command": "python",
      "args": ["weather.py"],
      "transport": "stdio"
    }
  ]
}
```
- 'serverName': 您为此服务器自定义的名称，例如 "weather-mcp"，在 Claude 界面中会显示此名称。
- 'command': 启动服务器的命令，这里使用 'python' 解释器来运行 Python 脚本。
- 'args': 传递给 'python' 命令的参数，指定要运行的服务器脚本为 'weather.py'。请确保 'weather.py' 文件位于 Claude 可以访问的路径下，或者使用绝对路径。如果您的工作目录就是仓库根目录，则可以直接使用 'weather.py'。
- 'transport': 指定 MCP 服务器使用的传输协议，这里设置为 'stdio'，表示使用标准输入输出流进行通信。

注意: 如果您的 'claude_desktop_config.json' 文件中已经存在 'servers' 数组，请将上述配置添加到数组中，而不是替换整个数组。

基本使用方法

启动 Claude Desktop app: 完成配置后，启动或重启 Claude Desktop app。
验证连接: 如果配置正确，在 Claude Desktop app 的文本输入框的右侧，您应该能看到一个锤子状的图标，这表示 MCP 服务器已成功连接。
发送天气查询: 现在您可以向 Claude 提出与天气相关的问题，例如：
- "北京今天天气怎么样？" (虽然此工具设计为美国天气服务，但您可以尝试其他地理位置的查询，取决于 NWS API 的覆盖范围)
- "加州有什么天气警报？"
- "纽约未来五天的天气预报是什么？"
当您的问题与天气相关时，Claude 将会自动调用 Weather MCP Server 提供的工具来获取信息，并将结果返回给您。

请注意：此服务器依赖于美国国家气象局 (NWS) API，因此可能主要适用于查询美国地区的天气信息。对于其他地区的天气查询，结果可能不准确或无法获取。

关键词