
Weather MCP Tool for Claude Desktop

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天)
- 空气质量信息
- 天气警报和警告
- 位置搜索功能
适用场景
- 个人天气查询
- 旅行计划
- 天气数据分析和比较
- 天气警报监控
工具列表
- get_current_weather:获取指定位置的实时天气状况
- get_weather_forecast:获取指定位置的天气预报
- get_air_quality:获取指定位置的空气质量数据
- get_historical_weather:获取指定日期和位置的历史天气数据
- search_location:按名称搜索位置
- get_weather_alerts:获取指定位置的天气警报
常见问题解答
- API密钥激活可能需要24小时
- 401错误通常表示API密钥无效
- 免费层每分钟最多允许60次调用
使用教程
使用依赖
- 确保已安装Python 3.10或更高版本
安装教程
- 安装依赖:
pip install -r requirements.txt
- 从OpenWeatherMap获取API密钥
- 设置环境变量:
- 创建.env文件并添加:
OPENWEATHER_API_KEY=your_openweathermap_api_key
- 更新main.py以使用环境变量
调试方式
- 确保服务器正在运行
- 验证设置中的路径是否正确
- 检查Python 3.10+是否在系统PATH中
- 确认所有依赖已安装
- 尝试重启Claude Desktop
- 检查日志中的错误消息