天气 MCP 服务器

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

功能

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

先决条件

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

安装

使用 Smithery 安装

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

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 -> Settings -> Developer -> Edit Config
{
  "mcpServers": {
      "mcp-weather-project": {
          "command": "uv",
          "args": [
              "--directory",
              "/<绝对路径>/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
# 或者在 Windows 上
.venv/Scripts/activate

# 安装依赖
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 获取天气信息。

许可证

此项目licensed under the MIT License - 请查看 LICENSE 文件以获取详细信息。