天气数据服务

一个基于OpenWeatherMap API的现代代码协议(MCP)服务器,提供实时天气数据检索,包括温度、湿度、风速、日出日落时间等详细信息。

  • by CodeByWaqas
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 CodeByWaqas/weather-mcp-server

使用说明

气象MCP服务器

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

特性

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

先决条件

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

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面版天气MCP服务器 史密瑟里:

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

手动安装

  1. 克隆存储库
  2. 创建虚拟环境:
python -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate
  1. 安装依赖项:
pip install -e .

安装说明

使用Claude Desktop进行设置

# claude_desktop_config.json
# Can find location through:
# Claude -> Settings -> Developer -> Edit Config
{
  "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

# Create virtual environment and activate it
uv venv

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

# Install dependencies
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许可证获得许可-有关详细信息,请参阅许可证文件。