Codebywaqas Weather MCP Server

🚀 天气 MCP 服务器

一个使用 OpenWeatherMap API 提供天气信息的现代代码协议（MCP）服务器，能让你轻松获取实时且详细的天气数据。

🚀 快速开始

运行 Claude Desktop 并使用 LLM 即可获取天气信息。

✨ 主要特性

• 实时天气数据获取
• 以度为单位的温度显示
• 详细的天气信息包括：
  • 温度
  • 湿度
  • 风速
  • 日出/日落时间
  • 天气描述

📦 安装指南

使用 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 .

📚 详细文档

开发/本地设置说明

克隆仓库

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

安装依赖项

安装 MCP 服务器的依赖项：

cd weather-mcp-server

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

source .venv/bin/activate # MacOS/Linux
# 或者
.venv/Scripts/activate # Windows

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

设置说明

配置与 Claude Desktop 使用

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

配置

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

WEATHER_API_KEY=your_api_key_here

📄 许可证

此项目在 MIT 许可证下，详情请见 LICENSE 文件。