Weather MCP Server

一个使用 OpenWeatherMap API 提供天气信息的现代代码协议 (MCP) 服务器。

特性

• 实时天气数据检索
• 温度的公制单位
• 详细的天气信息，包括：
  • 温度
  • 湿度
  • 风速
  • 日出/日落时间
  • 天气描述

前提条件

• Python 3.12 或更高版本
• OpenWeatherMap API 密钥

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Weather MCP Server：

npx -y @smithery/cli install @CodeByWaqas/weather-mcp-server --client claude

手动安装

1. 克隆存储库
2. 创建一个虚拟环境：

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上使用： .venv\Scripts\activate

3. 安装依赖项：

pip install -e .

设置说明

使用 Claude Desktop 设置

# claude_desktop_config.json
# 可以通过以下方式找到位置：
# Claude -> 设置 -> 开发者 -> 编辑配置
{
  "mcpServers": {
      "mcp-weather-project": {
          "command": "uv",
          "args": [
              "--directory",
              "/<absolute-path>/weather-mcp-server/src/resources",
              "run",
              "server.py"
          ],
          "env": {
            "WEATHER_API_KEY": "YOUR_API_KEY"
          }
      }
  }
}

本地/开发设置说明

克隆仓库

git clone https://github.com/CodeByWaqas/weather-mcp-server

安装依赖

安装 MCP 服务器依赖项：

cd weather-mcp-server

# 创建虚拟环境并激活它
uv venv

source .venv/bin/activate # MacOS/Linux
# OR
.venv/Scripts/activate # Windows

# 安装依赖项
uv add "mcp[cli]" python-dotenv requests httpx

配置

1. 将 src/resources/env.example 复制到 src/resources/.env
2. 将您的 OpenWeatherMap API 密钥添加到 .env 文件：

WEATHER_API_KEY=your_api_key_here

用法

运行 Claude Desktop 并使用 LLM 检索天气信息

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。