Open Meteo MCP Server

MCP开放气象服务器

用于访问Open Meteo天气数据和服务的综合模型上下文协议（MCP）服务器。该服务器提供多种工具与各种Open Meteo API进行交互，包括当前天气、预报、历史数据、空气质量、海洋天气和气候数据。

特性

🌤️ 气象服务

• 当前天气 -任何位置的实时天气状况
• 天气预报 -长达16天的详细小时和每日预报
• 历史天气 -过去的天气数据和综合统计数据

🌍 定位服务

• 地理编码 -搜索位置并获取坐标
• 反向地理编码 -从坐标中获取位置详细信息

🌊 环境数据

• 空气质量 -空气污染数据与空气质量指数（欧洲和美国）
• 海洋天气 -波高、洋流和海洋条件
• 气候数据 -长期气候预测和历史气候数据

📊 数据特征

• 多个温度单位（摄氏/华氏）
• 综合天气统计
• 空气质量健康建议
• 海上安全信息
• 气候模型比较

安装

地方发展

# Clone the repository
git clone 
cd mcp-open-meteo

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

Docker使用

构建并运行

# Build the Docker image
npm run docker:build

# Run the container
npm run docker:run

使用Docker Compose

# Build and start with compose
npm run docker:up

# Stop the service
npm run docker:down

# View logs
npm run docker:logs

用法

MCP配置

本地Node.js

将此服务器添加到MCP客户端配置中：

{
  "mcpServers": {
    "open-meteo": {
      "command": "node",
      "args": ["path/to/mcp-open-meteo/dist/index.js"]
    }
  }
}

码头工人

{
  "mcpServers": {
    "open-meteo": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "open-meteo-mcp-server"]
    }
  }
}

Docker Compose

{
  "mcpServers": {
    "open-meteo": {
      "command": "docker-compose",
      "args": ["run", "--rm", "open-meteo-mcp"]
    }
  }
}

可用工具

1.获取当前天气

获取任何位置的实时天气状况。

{
  "name": "get_current_weather",
  "arguments": {
    "latitude": 40.7128,
    "longitude": -74.0060,
    "units": "celsius"
  }
}

参数：

• latitude （必填）：纬度坐标（-90到90）
• longitude （必填）：经度坐标（-180至180）
• units （可选）：温度单位（“摄氏”或“华氏”，默认值：“摄氏”）

2.获取天气预报

获取详细的天气预报，包括每小时和每天的数据。

{
  "name": "get_weather_forecast",
  "arguments": {
    "latitude": 40.7128,
    "longitude": -74.0060,
    "days": 7,
    "hourly": true,
    "daily": true,
    "units": "celsius"
  }
}

参数：

• latitude （必填）：纬度坐标（-90到90）
• longitude （必填）：经度坐标（-180至180）
• days （可选）：预测天数（1-16，默认值：7）
• hourly （可选）：包括每小时预测（默认值：true）
• daily （可选）：包括每日预测（默认值：true）
• units （可选）：温度单位（默认值：“摄氏度”）

3.获取历史天气

检索历史天气数据进行分析。

{
  "name": "get_historical_weather",
  "arguments": {
    "latitude": 40.7128,
    "longitude": -74.0060,
    "start_date": "2023-01-01",
    "end_date": "2023-01-31",
    "daily": true,
    "hourly": false,
    "units": "celsius"
  }
}

参数：

• latitude （必填）：纬度坐标（-90到90）
• longitude （必填）：经度坐标（-180至180）
• start_date （必填）：开始日期，格式为YYYY-MM-DD
• end_date （必填）：YYYY-MM-DD格式的结束日期
• daily （可选）：包括每日数据（默认值：true）
• hourly （可选）：包括小时数据（默认值：false）
• units （可选）：温度单位（默认值：“摄氏度”）

4.搜索地点

按名称查找位置并获取其坐标。

{
  "name": "search_locations",
  "arguments": {
    "name": "New York",
    "count": 10,
    "language": "en"
  }
}

参数：

• name （必填）：要搜索的位置名称
• count （可选）：最大结果数（1-100，默认值：10）
• language （可选）：结果语言（默认值：“en”）

5.获得空气质量

检索空气质量数据和预报。

{
  "name": "get_air_quality",
  "arguments": {
    "latitude": 40.7128,
    "longitude": -74.0060,
    "days": 3,
    "current": true
  }
}

参数：

• latitude （必填）：纬度坐标（-90到90）
• longitude （必填）：经度坐标（-180至180）
• days （可选）：预测天数（1-5，默认值：3）
• current （可选）：包括当前空气质量（默认值：true）

6.获取海洋天气

获取海洋天气预报，包括海浪和海洋状况。

{
  "name": "get_marine_weather",
  "arguments": {
    "latitude": 40.7128,
    "longitude": -74.0060,
    "days": 7
  }
}

参数：

• latitude （必填）：纬度坐标（-90到90）
• longitude （必填）：经度坐标（-180至180）
• days （可选）：预测天数（1-7，默认值：7）

7.获取气候数据

获取气候变化情景和长期气候数据。

{
  "name": "get_climate_data",
  "arguments": {
    "latitude": 40.7128,
    "longitude": -74.0060,
    "start_date": "2020-01-01",
    "end_date": "2020-12-31",
    "models": ["EC_Earth3P_HR", "FGOALS_f3_H"]
  }
}

参数：

• latitude （必填）：纬度坐标（-90到90）
• longitude （必填）：经度坐标（-180至180）
• start_date （必填）：开始日期，格式为YYYY-MM-DD
• end_date （必填）：YYYY-MM-DD格式的结束日期
• models （可选）：要使用的气候模型阵列

可用气候模型

• EC_Earth3P_HR -EC-Earth3P-HR（高分辨率欧洲中心）
• FGOALS_f3_H -FGOALS-f3-H（中国科学院）
• HiRAM_SIT_HR -HiRAM SIT HR（美国国家海洋和大气管理局高分辨率）
• MRI_AGCM3_2_S -MRI-AGCM3-2-S（日本气象研究所）
• EC_Earth3P -EC-Earth3P（欧洲中心标准）
• FGOALS_f3 -FGOALS-f3（中国科学院标准）
• MPI_ESM1_2_HR -MPI-ESM1-2-HR（马克斯·普朗克研究所高分辨率）
• MRI_AGCM3_2 -MRI-AGCM3-2（日本气象研究所标准）

示例工作流

1.完成城市天气分析

# 1. First, search for the location
search_locations: {name: "London, UK"}

# 2. Get current weather
get_current_weather: {latitude: 51.5074, longitude: -0.1278}

# 3. Get 7-day forecast
get_weather_forecast: {latitude: 51.5074, longitude: -0.1278, days: 7}

# 4. Check air quality
get_air_quality: {latitude: 51.5074, longitude: -0.1278}

2.历史天气分析

# Compare weather patterns between years
get_historical_weather: {
  latitude: 40.7128, 
  longitude: -74.0060, 
  start_date: "2022-06-01", 
  end_date: "2022-08-31"
}

get_historical_weather: {
  latitude: 40.7128, 
  longitude: -74.0060, 
  start_date: "2023-06-01", 
  end_date: "2023-08-31"
}

3.航海海洋天气

# Check marine conditions before sailing
get_marine_weather: {latitude: 36.1699, longitude: -5.3543, days: 3}
get_weather_forecast: {latitude: 36.1699, longitude: -5.3543, days: 3}

4.气候研究

# Long-term climate analysis
get_climate_data: {
  latitude: 59.3293,
  longitude: 18.0686,
  start_date: "1990-01-01",
  end_date: "2020-12-31",
  models: ["EC_Earth3P_HR", "MPI_ESM1_2_HR"]
}

数据源

此服务器使用以下Open Meteo API：

• 天气API -当前天气和预报
• 历史天气API -过去的天气数据
• 地理编码API -位置搜索和坐标
• 空气质量API -污染和空气质量数据
• API海洋天气 -海洋和波浪条件
• 气候API -长期气候数据和预测

发展

项目结构

src/
├── index.ts              # Main MCP server
├── types/
│   └── openmeteo.ts     # TypeScript types and schemas
└── tools/
    ├── current-weather.ts    # Current weather tool
    ├── weather-forecast.ts   # Weather forecast tool
    ├── historical-weather.ts # Historical weather tool
    ├── geocoding.ts         # Location search tool
    ├── air-quality.ts       # Air quality tool
    ├── marine-weather.ts    # Marine weather tool
    └── climate-data.ts      # Climate data tool

构建命令

# Install dependencies
npm install

# Build TypeScript
npm run build

# Start development server
npm run dev

# Watch for changes
npm run watch

# Clean build directory
npm run clean

添加新工具

1. 在中创建新的工具文件 src/tools/
2. 导出一个处理工具逻辑的异步函数
3. 将该工具添加到中的导入中 src/index.ts
4. 将工具定义添加到 ListToolsRequestSchema 处理器
5. 将工具箱添加到 CallToolRequestSchema 处理器

API费率限制

Open Meteo API有以下速率限制：

• 免费套餐：每天10000个API调用
• 商业层：可用更高的限制

对于高容量使用，请考虑：

• 实施缓存机制
• 使用商业API进行更高的速率限制
• 尽可能分批处理请求

错误处理

服务器包括全面的错误处理：

• 所有参数的输入验证
• API错误响应处理
• 网络超时和重试逻辑
• 信息性错误消息

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件

致谢

• 开放天气 提供免费天气API
• 模型上下文协议 对于MCP规范

支持

对于问题和疑问：

1. 检查 打开Meteo文档
2. 查看错误消息以获取具体指导
3. 在此存储库中打开一个问题，以查找错误或功能请求