OpenWeather MCP 服务器

English | 中文版

一个简单的天气预报 MCP (模型控制协议) 服务器，提供全球天气预报和当前天气状况。

<img src="image.png" alt="Claude Desktop 使用 MCP 天气服务" width="600">

Claude Desktop 使用 MCP 天气服务的截图

特性

• 无需单独的配置文件；API 密钥可以直接通过环境变量或参数传递
• 支持查询世界任何地方的天气状况
• 提供当前天气和未来预报
• 详细的天气信息，包括温度、湿度、风速等
• 支持不同的时区

安装要求

pip install mcp-server requests pydantic

使用方法

1. 获取 OpenWeatherMap API 密钥

访问 OpenWeatherMap 并注册一个帐户以获取 API 密钥。

2. 运行服务器

有两种方法可以提供 API 密钥：

方法 1：使用环境变量

# 设置环境变量
export OPENWEATHER_API_KEY="your_api_key"  # Linux/Mac
set OPENWEATHER_API_KEY=your_api_key  # Windows

# 运行服务器
python weather_mcp_server.py

方法 2：在调用工具时提供

直接运行，无需设置环境变量：

python weather_mcp_server.py

在调用工具时，您需要提供 api_key 参数。

3. 在 MCP 客户端配置中使用

将以下配置添加到您的 MCP 支持的客户端：

{
  "weather_forecast": {
    "command": "python",
    "args": [
      "/full_path/weather_mcp_server.py"
    ],
    "env": {
      "OPENWEATHER_API_KEY": "your_openweathermap_key_here"
    },
    "disabled": false,
    "autoApprove": ["get_weather", "get_current_weather"]
  }
}

4. 可用工具

get_weather

获取指定位置的当前天气和预报。

参数：

• location: 位置名称，例如，“北京”、“纽约”、“东京”
• api_key: OpenWeatherMap API 密钥（可选，如果未提供，将从环境变量中读取）
• timezone_offset: 时区偏移量（以小时为单位），例如，北京为 8，纽约为 -4。 默认为 0（UTC 时间）

get_current_weather

获取指定位置的当前天气。

参数：

• location: 位置名称，例如，“北京”、“纽约”、“东京”
• api_key: OpenWeatherMap API 密钥（可选，如果未提供，将从环境变量中读取）
• timezone_offset: 时区偏移量（以小时为单位），例如，北京为 8，纽约为 -4。 默认为 0（UTC 时间）

使用示例

AI 助手调用示例：

User: 现在纽约的天气怎么样？

AI: 让我为您查询纽约的当前天气。
[Calling get_current_weather("New York", timezone_offset=-4)]

纽约当前天气：18°C，多云，湿度 65%，风速 3.5m/s。

故障排除

如果您遇到“No API key provided”错误，请确保：

1. 您已在环境变量中设置 OPENWEATHER_API_KEY，或者
2. 您在调用工具时提供了 api_key 参数

如果位置名称不正确，您可能会收到“Location not found”错误。 尝试使用更准确的城市名称或添加国家/地区代码，例如“Beijing,CN”或“Paris,FR”。