如何使用Weather MCP服务器

开始使用

安装与配置

1. 安装依赖项：

   pip install openweathermap-api python-multipart
   

2. 设置API密钥：

   • 在环境变量中设置 OPENWEATHER_API_KEY：

     export OPENWEATHER_API_KEY="your_api_key"
     

   • 或者在代码中直接传递 api_key 参数。

3. 运行服务器：

   python3 weather_mcp_server.py
   

功能概述

MCP服务器功能

• 提供两个工具：get_weather 和 get_current_weather
• 使用OpenWeatherMap的One Call API 3.0
• 支持8天天气预报（包括今天和未来7天）
• 包含每个时间段的早间、午间和晚间天气数据
• 显示风速、降水量和其他天气摘要

输入输出示例

示例输入：

{
  "city": "New York",
  "state": "NY",
  "country": "US"
}

示例输出：

{
  "current_weather": {
    "temperature": 22,
    "condition": "Partly Cloudy",
    "wind_speed": 12,
    "humidity": 65
  },
  "hourly_forecast": [...],
  "daily_forecast": [...]
}

使用说明

基本用法

# 获取当前天气
python3 weather_mcp_server.py --current-weather --city New York

# 获取天气预报
python3 weather_mcp_server.py --weather-forecast --location "Beijing,China"

高级功能

• 支持多天天气数据查询（最多8天）
• 可指定具体时间点的天气信息
• 提供详细的气象数据，包括降水量、风向等

问题排查

API密钥问题

1. 确保已订阅OpenWeatherMap的One Call API 3.0计划
2. 确认API密钥在环境变量中正确设置
3. 检查是否有超过免费配额的情况

其他常见问题

• 位置未找到：检查输入的准确性，尝试添加国家代码
• 速率限制：减少API调用频率或升级至付费计划

开发与测试

自动化测试

1. 单元测试：

   python test_weather_mcp.py
   

2. 集成测试：

   python integration_test.py
   

手动测试

# 运行测试客户端
python3 weather_test_client.py --test-all

最后更新：2023年11月4日