气象数据服务

提供全球气象数据和农业洞察的MCP服务器,支持实时天气、每日预报、小时预报和历史数据查询。

  • by eagleisbatman
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 eagleisbatman/google-weather-mcp

使用说明

谷歌天气MCP服务器

MCP(模型上下文协议)服务器从Google weather API提供具有农业见解的全球天气数据。

特性

  • 当前状况:实时天气,包括温度、湿度、风、紫外线指数和喷雾建议
  • 每日预报:长达10天的预报,包括最低/最高温度、降水概率
  • 逐时预报:最多240小时(10天)的每小时天气数据,带有喷雾窗口检测功能
  • 小时历史:过去24小时的天气数据(谷歌天气独有)

快速开始

1.安装依赖项

cd mcp-servers/google-weather-mcp
npm install

2.配置环境

cp .env.example .env
# Edit .env and add your Google Weather API key

3.运行服务器

# Development
npm run dev

# Production
npm run build && npm start

API密钥设置

  1. 首选 谷歌云控制台
  2. 创建或选择项目
  3. 启用天气API
  4. 创建API密钥
  5. 将密钥添加到您的 .env 归档 GOOGLE_WEATHER_API_KEY

MCP工具

1. get_google_current_conditions

获取某个位置的实时天气状况。

参数:

  • latitude (可选):纬度坐标(-90到90)
  • longitude (可选):经度坐标(-180到180)

答复包括:

  • 温度(电流和感觉)
  • 湿度、露点
  • 风速、风向、阵风
  • 紫外线指数
  • 降水概率
  • 云层覆盖、能见度、压力
  • 喷雾条件评估

2. get_google_daily_forecast

获取每日天气预报以进行规划。

参数:

  • latitude (可选):纬度坐标
  • longitude (可选):经度坐标
  • days (可选):天数1-10(默认值:7)

答复包括:

  • 每日最低/最高温度
  • 降水概率和降水量
  • 风力条件
  • 紫外线指数
  • 日出/日落时间
  • 农业影响评估

3. get_google_hourly_forecast

获取每小时的天气预报,以便进行精确规划。

参数:

  • latitude (可选):纬度坐标
  • longitude (可选):经度坐标
  • hours (可选):小时数1-240(默认值:24)

答复包括:

  • 每小时温度和条件
  • 风速与风向
  • 降水概率
  • 云量
  • 喷雾窗检测

4. get_google_hourly_history

获取过去24小时的历史天气数据。

参数:

  • latitude (可选):纬度坐标
  • longitude (可选):经度坐标
  • hours (可选):过去小时数1-24(默认值:24)

答复包括:

  • 历史温度
  • 湿度水平
  • 降水量
  • 风力条件
  • 汇总统计

端点

端点 方法 描述
/ GET 服务器信息和可用工具
/health GET 健康检查
/mcp POST MCP协议端点

环境变量

变量 必填 默认 描述
GOOGLE_WEATHER_API_KEY 是 - Google Weather API密钥
GOOGLE_WEATHER_API_BASE_URL 没有 https://weather.googleapis.com/v1 API基本URL
PORT 没有 3003 服务器端口
ALLOWED_ORIGINS 没有 * CORS允许的来源

响应格式

所有工具都返回规范化的JSON:

{
  "product": "Google Weather <Product>",
  "provider": "Google Weather",
  "location": {
    "latitude": 12.9716,
    "longitude": 77.5946,
    "coverage": "Global"
  },
  "current": { ... },
  "forecast": [ ... ],
  "agricultural_context": {
    "conditions_summary": "...",
    "spray_assessment": { ... }
  },
  "data_source": "Google Weather API"
}

农业背景

该服务器提供农业见解,包括:

  • 喷雾条件:评估风、湿度和降水量,以建议喷雾时间
  • 喷雾窗:确定每小时预测中喷洒的最佳时间窗口
  • 农业影响:描述天气条件如何影响农业活动

部署

铁路

# Deploy to Railway
railway up

这 railway.json 文件已预先配置用于部署。

环境变量(铁路)

在铁路项目中设置这些:

  • GOOGLE_WEATHER_API_KEY:您的API密钥
  • PORT:将由铁路自动设置

与其他天气提供商的比较

功能 AccuWeather Tomorrow.io 谷歌天气
预测天数 5 14 10
每小时预测 有限 48小时 240小时
历史数据 否 否 是(24小时)
喷雾窗 否 是 是
农业背景 否 是 是
图标格式 数字代码 数字代码 URL字符串

许可证

麻省理工学院