一种 MCP（模型上下文协议）工具，使用 OpenWeatherMap API 提供实时天气数据、预报和历史天气信息，专为 Claude Desktop 设计。
有关设置和使用此工具的详细指南，请查看我们全面的 Medium 教程： 教程：使用 Claude Desktop 和 Weather MCP 工具访问全球实时天气数据
Related MCP server: weather-mcp-server
任何地点的实时天气状况
天气预报（最多 5 天）
历史天气数据（最近5天）
空气质量信息
天气警报和警告
位置搜索功能
确保安装了 Python 3.10 或更高版本
安装依赖项：
pip install -r requirements.txt从OpenWeatherMap获取 API 密钥（提供免费套餐）
注意：新的 API 密钥可能需要最多 24 小时才能激活
设置 API 密钥的环境变量（推荐方法）：
在项目目录中创建.env文件
将您的 API 密钥添加到文件：GXP2
将.env添加到.gitignore文件以防止提交敏感数据
更新main.py以使用环境变量：
# Add these imports at the top
import os
from dotenv import load_dotenv
# Load environment variables
load_dotenv()
# Replace the API_KEY line with
API_KEY = os.getenv("OPENWEATHER_API_KEY")通过将以下内容添加到您的 MCP 配置中，在 Claude Desktop 中配置您的 MCP 设置：
{
"mcpServers": {
"weather-mcp": {
"command": "py",
"args": ["-3.13", "C:\\Path\\To\\Your\\Weather-MCP-ClaudeDesktop\\main.py"]
}
}
}将路径替换为 main.py 文件的完整路径
使用以下命令运行服务器：
py -3.13 main.py使用 Claude Desktop 时保持服务器运行
获取某个地点的实时天气状况：
{
"location": {
"name": "New York",
"country": "US",
"lat": 40.7128,
"lon": -74.006
},
"temperature": {
"current": 25.6,
"feels_like": 26.2,
"min": 23.4,
"max": 27.8
},
"weather_condition": {
"main": "Clear",
"description": "clear sky",
"icon": "01d"
},
"wind": {
"speed": 3.6,
"deg": 220
},
"clouds": 5,
"humidity": 65,
"pressure": 1015,
"visibility": 10000,
"sunrise": "2025-03-16T06:12:34",
"sunset": "2025-03-16T18:04:23",
"timestamp": "2025-03-16T14:30:00"
}获取某个地点的天气预报：
{
"location": {
"name": "London",
"country": "GB",
"lat": 51.5074,
"lon": -0.1278
},
"forecast": [
{
"datetime": "2025-03-16T15:00:00",
"temperature": {
"temp": 18.2,
"feels_like": 17.8,
"min": 17.5,
"max": 19.1
},
"weather_condition": {
"main": "Rain",
"description": "light rain",
"icon": "10d"
},
"wind": {
"speed": 4.2,
"deg": 180
},
"clouds": 75,
"humidity": 82,
"pressure": 1010,
"visibility": 8000,
"pop": 0.4
}
// ... more forecast items
],
"days": 5
}获取某个地点的空气质量数据：
{
"location": {
"name": "Beijing",
"country": "CN",
"lat": 39.9042,
"lon": 116.4074
},
"air_quality_index": 3,
"air_quality_level": "Moderate",
"components": {
"co": 250.34,
"no": 0.5,
"no2": 15.2,
"o3": 140.8,
"so2": 5.1,
"pm2_5": 8.2,
"pm10": 12.3,
"nh3": 0.7
},
"timestamp": "2025-03-16T14:30:00"
}获取特定日期的历史天气数据：
{
"location": {
"name": "Paris",
"country": "FR",
"lat": 48.8566,
"lon": 2.3522
},
"date": "2025-03-14",
"temperature": {
"temp": 20.3,
"feels_like": 19.8
},
"weather_condition": {
"main": "Clouds",
"description": "scattered clouds",
"icon": "03d"
},
"wind": {
"speed": 2.8,
"deg": 150
},
"clouds": 45,
"humidity": 60,
"pressure": 1012,
"visibility": 10000,
"sunrise": "2025-03-14T06:30:45",
"sunset": "2025-03-14T18:15:22",
"timestamp": "2025-03-14T12:00:00"
}按名称搜索地点：
{
"results": [
{
"name": "Tokyo",
"state": "",
"country": "JP",
"lat": 35.6762,
"lon": 139.6503
},
{
"name": "Tokyo",
"state": "Tokyo",
"country": "JP",
"lat": 35.6895,
"lon": 139.6917
}
// ... more results
]
}获取某个位置的天气警报：
{
"location": {
"name": "Miami",
"country": "US",
"lat": 25.7617,
"lon": -80.1918
},
"alerts": [
{
"sender": "NWS Miami",
"event": "Heat Advisory",
"start": "2025-03-16T12:00:00",
"end": "2025-03-16T20:00:00",
"description": "Heat index values between 105 and 110 expected",
"tags": ["Extreme temperature value"]
}
// ... more alerts if any
],
"alert_count": 1
}您可以向 Claude Desktop 询问以下问题：
“纽约现在的天气怎么样？”
“显示伦敦未来 5 天的天气预报”
“今天北京的空气质量怎么样？”
“3月14日巴黎的天气怎么样？”
“搜索名为‘东京’的地点”
“迈阿密有天气预警吗？”
“比较芝加哥、迈阿密和西雅图的当前天气”
“给我看看北京、洛杉矶和德里的空气质量对比”
所有工具都包含适当的错误处理，如果出现问题，将返回错误消息：
{
"error": "Failed to fetch current weather for InvalidLocation: Location not found"
}如果 MCP 服务器在 Claude Desktop 中无法运行：
确保服务器正在运行 - 启动脚本时您应该看到输出
验证设置中的路径是否正确且绝对
确保 Python 3.10+ 位于你的系统 PATH 中
检查所有依赖项是否已安装
尝试重启 Claude Desktop
检查日志中是否有任何错误消息
API 密钥激活：新的 OpenWeatherMap API 密钥可能需要长达 24 小时才能激活
无效 API 密钥错误：如果收到 401 错误，请验证您的 API 密钥是否正确且有效
速率限制：免费套餐允许每分钟最多 60 次通话，在高使用率时可能会超过此限制
此工具使用 OpenWeatherMap API，该 API 具有速率限制。免费套餐每分钟最多允许 60 次调用，这足以满足个人使用需求。请注意，非常频繁的请求可能会受到 API 的限制。
MIT 许可证
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
No tool schema history has been recorded yet.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Global weather via Open-Meteo: forecast, ERA5 archive, marine, air quality, geocoding, elevation.
Current weather and forecasts for any coordinates, backed b… — paid per call (x402/credits), 1 tools
Real-time weather conditions and multi-day forecasts via Open-Meteo — free, no API key required
Global weather API: forecasts, historical data, marine, ski, astronomy and timezone.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/SaintDoresh/Weather-MCP-ClaudeDesktop'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
