Weather MCP Server

Weather MCP Server

site icon
2025.04.04 0
Python天气服务位置服务
Weather MCP Server 是一个基于 Modern Code Protocol (MCP) 的服务,利用 OpenWeatherMap API 提供实时天气信息。该服务能够获取包括温度、湿度、风速、日出日落时间以及天气描述等详细的天气数据。
View on GitHub

Overview

基本能力

产品定位

Weather MCP Server 是一个提供实时天气信息的服务,适用于需要集成天气数据的应用或系统。

核心功能

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

适用场景

  • 需要实时天气信息的应用
  • 集成天气数据的系统
  • 个人或企业天气查询工具

工具列表

  • OpenWeatherMap API:用于获取天气数据
  • Smithery:用于自动安装服务

常见问题解答

  1. 如何获取 OpenWeatherMap API key? 需要注册 OpenWeatherMap 账户并申请 API key。
  2. 如何配置服务? 复制 src/resources/env.examplesrc/resources/.env 并添加 API key。

使用教程

使用依赖

  • Python 3.12 或更高版本
  • OpenWeatherMap API key

安装教程

通过 Smithery 安装

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
  1. 安装依赖:
pip install -e .

调试方式

  1. 配置 Claude Desktop:
{
  "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"
          }
      }
  }
}
  1. 运行 Claude Desktop 并使用 LLM 检索天气信息。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。