Weather MCP Tool for Claude Desktop

Weather MCP Tool for Claude Desktop

site icon
2025.03.16 3
Python天气服务位置服务位置服务
Weather-MCP-ClaudeDesktop 是一个基于 OpenWeatherMap API 的 MCP(Model Context Protocol)工具,专为 Claude Desktop 设计,提供实时天气数据、天气预报、历史天气信息、空气质量数据以及天气警报等功能。
View on GitHub

Overview

基本能力

产品定位

Weather-MCP-ClaudeDesktop 是一个天气数据服务工具,旨在为 Claude Desktop 用户提供全球范围内的实时天气信息和相关数据。

核心功能

  • 实时天气条件查询
  • 天气预报(最多5天)
  • 历史天气数据查询(最近5天)
  • 空气质量信息
  • 天气警报和警告
  • 位置搜索功能

适用场景

  • 个人天气查询
  • 旅行计划
  • 天气数据分析和比较
  • 天气警报监控

工具列表

  1. get_current_weather:获取指定位置的实时天气状况
  2. get_weather_forecast:获取指定位置的天气预报
  3. get_air_quality:获取指定位置的空气质量数据
  4. get_historical_weather:获取指定日期和位置的历史天气数据
  5. search_location:按名称搜索位置
  6. get_weather_alerts:获取指定位置的天气警报

常见问题解答

  • API密钥激活可能需要24小时
  • 401错误通常表示API密钥无效
  • 免费层每分钟最多允许60次调用

使用教程

使用依赖

  1. 确保已安装Python 3.10或更高版本

安装教程

  1. 安装依赖:
pip install -r requirements.txt
  1. 从OpenWeatherMap获取API密钥
  2. 设置环境变量:
  3. 创建.env文件并添加: OPENWEATHER_API_KEY=your_openweathermap_api_key
  4. 更新main.py以使用环境变量

调试方式

  1. 确保服务器正在运行
  2. 验证设置中的路径是否正确
  3. 检查Python 3.10+是否在系统PATH中
  4. 确认所有依赖已安装
  5. 尝试重启Claude Desktop
  6. 检查日志中的错误消息

许可证

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