使用说明

项目简介

Weather MCP Server 是一个实现了 Model Context Protocol (MCP) 的后端服务器，旨在为大型语言模型 (LLM) 客户端（如 Claude Desktop）提供实时的天气信息和基础的系统工具。它通过工具 (Tools) 的形式暴露功能，允许 LLM 客户端通过标准的 MCP 协议调用这些工具来获取天气预警、天气预报以及执行一些简单的系统命令，从而增强 LLM 的上下文感知和外部功能调用能力。

主要功能点

天气信息查询: 提供指定地区的天气预警查询和经纬度坐标的天气预报查询。
系统工具: 允许执行 shell 命令并查看当前系统进程信息（例如，CPU 占用率最高的进程）。
MCP 协议集成: 完全遵循 MCP 协议标准，可以无缝集成到任何支持 MCP 协议的 LLM 客户端。

安装步骤

安装 Python: 确保您的系统已安装 Python 3.11 或更高版本。
安装 uv 包管理器: 按照 uv 官方文档指引安装 uv 包管理器 (如果尚未安装)。

克隆仓库: 使用 Git 克隆 weather 仓库到本地：

git clone https://github.com/jalateras/weather.git
cd weather

安装依赖: 在仓库根目录下，使用 uv 安装项目依赖：
```
make install
```

服务器配置

为了让 MCP 客户端（例如 Claude Desktop）连接到 Weather MCP Server，您需要在客户端的配置中指定服务器的启动方式。以下是 Claude Desktop 的配置示例，您需要根据实际情况修改 'cwd' 字段中的路径：

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["-m", "main"],
      "cwd": "/path/to/weather"  // 请替换为 weather 仓库在您本地的绝对路径
    }
  }
}

配置参数说明:

'"weather"': 服务器名称，可以自定义，用于在客户端中标识该服务器。
'"command": "python"': 启动服务器的命令，这里使用 python 解释器。
'"args": ["-m", "main"]': 传递给 'python' 命令的参数，'-m main' 表示运行 'main.py' 模块，即启动 Weather MCP Server。
'"cwd": "/path/to/weather"': 务必修改。指定服务器启动时的工作目录，需要设置为您克隆的 'weather' 仓库的绝对路径。

配置完成后，重启您的 MCP 客户端，客户端应该能够自动连接到 Weather MCP Server。

基本使用方法

成功配置并连接服务器后，您可以通过 MCP 客户端向 Weather MCP Server 发送请求，调用其提供的工具。例如，在 Claude 中，您可以提问类似以下问题来使用 Weather MCP Server 的功能：

"What are the current weather alerts in CA?" (查询加州的天气预警)
"What's the forecast for latitude 37.7749, longitude -122.4194?" (查询指定经纬度的天气预报)
"What processes are using the most CPU on my system?" (查询当前系统 CPU 占用率最高的进程)

客户端会将这些自然语言问题转换为对 MCP 服务器工具的调用，并将结果返回给您。您也可以使用 MCP Inspector 或 MCP CLI 等工具来直接测试和调用服务器提供的工具。

关键词