天气查询服务

一个基于OpenWeatherMap API的墨西哥城市天气查询和预报服务,提供当前天气和5天预报功能。

  • by TonyVM
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 tonyvm/weather-mx-mcp-server

使用说明

天气墨西哥MCP服务器

MCP服务器使用OpenWeatherMap API查询墨西哥城市的当前气候和预测。

🚀 主要特征

  • 按城市和州划分的当前气候查询
  • 5天天气预报
  • 拥有9320多个墨西哥城市的数据库
  • 自动名称标准化(重音和大写/小写)
  • 解决重复名称城市的歧义

📦 快速安装

  1. 克隆存储库:

    git clone <repo-url>
    cd weather_mx
    
  2. 安装依赖项:

    pip install -r requirements.txt
    # O si usas pyproject.toml:
    pip install pandas httpx python-dotenv fastmcp
    
  3. 设置您的API密钥:

    • 注册 OpenWeatherMap 并将您的API密钥复制到文件中 .env:
      OPENWEATHER_API_KEY=tu_api_key_aqui
      

🛠️ 基本用途

运行MCP服务器:

python main.py

主要功能

  • get_weather_mexico(city, state)
    一个城市和州的当前气候。
  • get_forecast_mexico(city)
    一个城市的5天天气预报。

查询示例:

get_weather_mexico("merida", "yucatan")
get_weather_mexico("guadalupe", "zacatecas")

自然语言示例:

  • “给我萨卡特卡斯瓜达卢佩市的天气”
  • “蒙特雷气候女士”
  • “墨西哥城的天气怎么样?”
  • “梅里达的天气如何?”

📊 数据库

  • 文件: cities.json
  • 坎波斯: name, latitude, longitude, state_name
  • 格式:JSON

🔧 项目基本档案

weather_mx/
├── main.py         # Servidor MCP principal
├── cities.json     # Base de datos de ciudades mexicanas
├── pyproject.toml  # Configuración de dependencias
├── .env            # Variables de entorno (API key)
└── README.md       # Documentación

📝 许可证

麻省理工学院

🙏 学分


墨西哥天气MCP服务器(英语)

MCP服务器,使用OpenWeatherMap API获取墨西哥城市的当前天气和预报。

🚀 主要特点

  • 按城市和州获取当前天气
  • 5天天气预报
  • 拥有9320多个墨西哥城市的数据库
  • 名称(重音和大小写)的自动规范化
  • 解决了名称重复的城市的歧义

📦 快速安装

  1. 克隆存储库:

    git clone <repo-url>
    cd weather_mx
    
  2. 安装依赖项:

    pip install -r requirements.txt
    # Or if you use pyproject.toml:
    pip install pandas httpx python-dotenv fastmcp
    
  3. 配置API密钥:

    • 注册地址: OpenWeatherMap 并将您的API密钥复制到 .env 文件:
      OPENWEATHER_API_KEY=your_api_key_here
      

🛠️ 基本用法

运行MCP服务器:

python main.py

主要功能

  • get_weather_mexico(city, state)
    获取城市和州的当前天气。
  • get_forecast_mexico(city)
    获取一个城市的5天天气预报。

示例查询:

get_weather_mexico("merida", "yucatan")
get_weather_mexico("guadalupe", "zacatecas")

自然语言示例:

  • “告诉我萨卡特卡斯瓜达卢佩的天气”
  • “蒙特雷的天气怎么样?”
  • “墨西哥城的天气怎么样?”
  • “梅里达的预测是什么?”

📊 数据库

  • 文件: cities.json
  • 领域: name, latitude, longitude, state_name
  • 格式:JSON

🔧 基本项目文件

weather_mx/
├── main.py         # Main MCP server
├── cities.json     # Mexican cities database
├── pyproject.toml  # Dependency configuration
├── .env            # Environment variables (API key)
└── README.md       # Documentation

📝 许可证

麻省理工学院

🙏 鸣谢

  • OpenWeatherMap
  • 地理数据:国家统计、地理信息研究所,datos.gob.mx