JinDaGe - wems-mcp-server MCP Details

article

README

🚀 世界事件监测系统 (WEMS)

WEMS（世界事件监测系统）是一个强大的模型上下文协议（MCP）服务器，它能将AI助手与权威的自然灾害数据源相连接。用户可通过该系统实时监测地震、海啸、火山和太阳活动等自然灾害，并可配置警报和Webhook通知。

🚀 快速开始

通过PyPI安装（推荐）

pip install wems-mcp-server

或从源代码安装

git clone https://github.com/heliosarchitect/wems-mcp-server.git
cd wems-mcp-server
pip install -r requirements.txt

基础用法

# 作为MCP服务器运行（连接到AI助手）
python -m wems_mcp_server

# 测试地震监测
python -c "
import asyncio
from wems_mcp_server import check_earthquakes
print(asyncio.run(check_earthquakes(min_magnitude=6.0)))
"

一键式AI警报设置（中继 + n8n）

bash scripts/setup_wems_alerting_ai.sh

此命令将执行以下操作：

安装并启动 wems-unified-relay.service
更新并激活统一的n8n摄取工作流
自动配置跟踪器发布凭证

示例输出

{
  "earthquakes_found": 3,
  "events": [
    {
      "magnitude": 7.2,
      "location": "67 km SW of Tres Picos, Mexico",
      "time": "2024-02-13T14:30:15Z",
      "depth": 35.8,
      "tsunami_threat": true
    }
  ]
}

✨ 主要特性

🌋 9个以上权威数据源：包括美国地质调查局（USGS）、美国国家海洋和大气管理局（NOAA）、史密森尼全球火山计划（Smithsonian GVP）、国家飓风中心（NHC）、国家跨部门消防中心（NIFC）、OpenAQ、美国国土安全部（DHS）、美国国务院、美国网络安全和基础设施安全局（CISA）、美国干旱监测中心等。
🎯 实时监测：提供实时数据流，并可自定义阈值。
🔔 智能警报：针对关键事件提供Webhook通知。
🗺️ 地理过滤：可针对特定区域或全球范围进行监测。
🔧 零配置：开箱即用，仅需配置所需内容。
🐳 生产就绪：支持Docker，具备全面的错误处理机制。

涵盖的自然灾害类型

| 灾害类型 | 数据源 | 覆盖范围 | |-------------|-------------|----------| | 🌊 地震 | 美国地质调查局（USGS） | 全球，可按震级过滤 | | 🌊 海啸 | 美国国家海洋和大气管理局太平洋海啸预警中心（NOAA PTWC）+ 美国国家海洋和大气管理局中央海啸预警中心（NOAA CTWC） | 全球海洋盆地 | | 🌋 火山 | 史密森尼全球火山计划（Smithsonian GVP）+ 美国地质调查局（USGS） | 全球火山活动 | | ☀️ 太阳活动 | 美国国家海洋和大气管理局空间天气预报中心（NOAA SWPC） | 太阳耀斑、日冕物质抛射、地磁风暴 | | 🌞 空间天气警报 | 美国国家海洋和大气管理局空间天气预报中心（NOAA SWPC） | 活跃的空间天气警报和警告 | | 🌀 飓风 | 国家飓风中心（NHC）+ 美国国家气象局（NWS） | 大西洋和太平洋热带气旋 | | 🔥 野火 | 美国国家气象局（NWS）+ 国家跨部门消防中心（NIFC） | 火灾天气警报和活跃的火灾边界 | | ⛈️ 恶劣天气 | 美国国家气象局警报（NWS Alerts） | 龙卷风、雷暴、洪水、冬季风暴 | | 💨 空气质量 | OpenAQ | 全球空气质量指数（AQI）、PM2.5、PM10、O₃、NO₂、SO₂、CO | | 🌵 干旱状况 | 美国干旱监测中心 | 美国各州干旱等级（D0 - D4）及趋势 | | 🛡️ 威胁预警 | 美国国土安全部国家恐怖主义咨询系统（DHS NTAS）+ 美国国务院 + 美国网络安全和基础设施安全局（CISA） | 恐怖主义、旅行风险、网络威胁 |

📦 MCP工具

| 工具 | 描述 | |------|-------------| | check_earthquakes | 查询近期地震活动 | | check_solar | 监测空间天气（K指数、耀斑、日冕物质抛射） | | check_volcanoes | 跟踪火山活动警报 | | check_tsunamis | 监测海啸预警 | | check_hurricanes | 跟踪热带气旋及预报路径 | | check_wildfires | 火灾天气警报和活跃的火灾边界 | | check_severe_weather | 监测龙卷风、雷暴、山洪暴发 | | check_floods | 洪水预警和美国地质调查局河流水位数据 | | check_air_quality | 空气质量指数监测及污染物数据 | | check_threat_advisories | 恐怖主义、旅行风险和网络威胁监测 | | check_space_weather_alerts | 美国国家海洋和大气管理局空间天气预报中心的活跃空间天气警报和警告 | | check_drought_status | 美国各州干旱状况（D0 - D4等级，高级功能） | | configure_alerts | 更新警报阈值和Webhook | | fuse_multi_source_incidents | 多源事件融合（功能标记） |

📚 详细文档

配置

alerts:
  earthquake:
    min_magnitude: 6.0
    regions: ["US", "Caribbean", "Pacific"]
    webhook: "https://your-endpoint.com/earthquake"
  
  solar:
    min_kp_index: 7  # 地磁风暴阈值
    webhook: "https://your-endpoint.com/solar"
    
  volcano:
    alert_levels: ["WARNING", "WATCH"]
    webhook: "https://your-endpoint.com/volcano"
    
  tsunami:
    enabled: true
    regions: ["pacific", "atlantic", "indian"]
    webhook: "https://your-endpoint.com/tsunami"

数据源

美国地质调查局地震灾害计划
美国国家海洋和大气管理局太平洋海啸预警中心
美国国家海洋和大气管理局中央海啸预警中心
史密森尼全球火山计划
美国国家海洋和大气管理局空间天气预报中心
国家飓风中心（NHC）
国家跨部门消防中心（NIFC）
美国国家气象局警报API
OpenAQ（全球空气质量）
美国国土安全部国家恐怖主义咨询系统（NTAS）
美国国务院旅行建议
美国网络安全和基础设施安全局网络安全建议

OpenClaw集成

将以下内容添加到您的OpenClaw配置中：

{
  "mcpServers": {
    "wems": {
      "command": "python3",
      "args": ["/path/to/wems-mcp-server/wems_mcp_server.py"],
      "env": {
        "WEMS_CONFIG": "/path/to/config.yaml"
      }
    }
  }
}

高级配置

# config.yaml - 完整自定义示例
alerts:
  earthquake:
    min_magnitude: 6.0
    regions: ["US", "Caribbean", "Pacific"]
    webhook: "https://your-endpoint.com/earthquake"
    
  solar:
    min_kp_index: 7  # G3+ 地磁风暴
    webhook: "https://your-endpoint.com/solar"
    
  volcano:
    alert_levels: ["WARNING", "WATCH"] 
    regions: ["Cascade Range", "Ring of Fire"]
    webhook: "https://your-endpoint.com/volcano"
    
  tsunami:
    enabled: true
    regions: ["pacific", "atlantic", "indian"]
    webhook: "https://your-endpoint.com/tsunami"

监测仪表盘

可与监测工具配合使用，以实现全面覆盖：

# 示例：将地震数据发送到监测系统
curl -X POST https://your-monitoring.com/api/events \
  -H "Content-Type: application/json" \
  -d "$(python -c 'import wems; print(wems.get_recent_earthquakes())')"

计费与货币化（当前）

WEMS现在包含Stripe计量框架和实惠的默认定价。

当前默认定价

免费套餐：每30天滚动5000次调用
0 - 100000次调用：每次调用0.0010美元
100001 - 500000次调用：每次调用0.0008美元
500001次以上调用：每次调用0.0006美元

附属调用权重（默认）

大多数工具：1 单位
check_space_weather_alerts：2 单位
fuse_multi_source_incidents：3 单位

计费配置

请参阅：config/wems_stripe_billing.json

关键字段：

event_name
api_key_to_customer
billing_units.default
billing_units.by_tool
pricing.free_calls_per_rolling_30d
pricing.tiers[]

Stripe密钥来源

STRIPE_API_KEY 或 STRIPE_SECRET_KEY（直接环境变量）

WEMS会尽力查找密钥，如果计费密钥解析失败，不会阻止警报功能。

🎯 使用场景

🏢 企业风险管理：为全球业务提供自动化威胁评估。
📺 新闻机构：实时自然灾害报道和警报。
🔬 研究机构：为科学分析收集数据。
🏠 个人安全：为家庭提供特定位置的灾害监测。
🤖 AI应急响应：与灾害响应聊天机器人集成。
📱 警报系统：为关键事件定制通知工作流。

由Helios为AI社区用心打造 🌞

属于不断扩展的 OpenClaw 生态系统的一部分

wems-mcp-server