🌍 Disaster Preparedness AI System

🌍 Disaster Preparedness AI System

site icon
2025.05.03 0
Python灾害预警实时数据AI增强位置服务
Disaster Preparedness AI System 是一个基于AI的灾害预警系统,旨在通过实时天气和地震数据提供灾害预警信息。该系统分为两部分:本地交互式MCP聊天界面和部署在AWS EC2上的灾害警报API服务器。本地聊天界面使用Groq驱动的LLM和MCPAgent,允许用户按州检索实时天气警报。API服务器则提供获取活跃天气警报和过去24小时内显著地震的工具。系统采用模块化设计,易于扩展,支持多种灾害类型和用户警报渠道。
View on GitHub

Overview

基本能力

产品定位

Disaster Preparedness AI System 是一个AI增强的灾害预警系统,旨在通过实时天气和地震数据提供灾害预警信息。

核心功能

  1. 本地交互式MCP聊天界面:使用Groq驱动的LLM和MCPAgent,允许用户按州检索实时天气警报。
  2. 灾害警报API服务器:提供获取活跃天气警报和过去24小时内显著地震的工具。
  3. 模块化设计:易于扩展,支持多种灾害类型和用户警报渠道。

适用场景

  1. 实时灾害预警和警报。
  2. 灾害数据分析和可视化。
  3. 灾害应急响应和准备。

工具列表

  1. FastMCP:用于构建代理和基于工具的应用程序的框架。
  2. LangChain + Groq:用于LLM聊天集成。
  3. httpx:异步HTTP客户端,用于数据获取。
  4. MCPAgent / MCPClient:用于管理工具和代理逻辑。
  5. NOAA National Weather Service API:获取天气警报。
  6. USGS Earthquake GeoJSON API:获取地震数据。

常见问题解答

  1. 如何运行本地服务器? 在代码中添加以下行并重启服务器: python if __name__ == "__main__": mcp.run() 在某些情况下,可能需要删除这些行并尝试重新启动服务器。

使用教程

使用依赖

  1. AWS账户(免费层)。
  2. GitHub仓库包含您的代码。
  3. .pem密钥对用于EC2访问。

安装教程

  1. 登录AWS控制台: 访问:https://console.aws.amazon.com

  2. 启动EC2实例

  3. EC2 → 启动实例
  4. 名称:mcp-server
  5. OS:Amazon Linux 2023(免费层资格)
  6. 类型:t2.micro
  7. 密钥对:创建/下载.pem文件
  8. 网络:启用SSH(端口22)和可选的HTTP(80)

  9. 通过SSH连接到EC2bash ssh -i "your-key.pem" ec2-user@<your-ec2-public-ip>

  10. 在EC2上安装Python和Gitbash sudo yum update -y sudo yum install python3 git -y

  11. 克隆GitHub仓库bash git clone https://github.com/your-username/your-repo.git cd your-repo

  12. 设置Python虚拟环境bash python3 -m venv venv source venv/bin/activate pip install -r requirements.txt

  13. 运行API服务器bash uvicorn disaster:app --host 0.0.0.0 --port 8000 在浏览器中打开收到的URL。

调试方式

  1. 本地运行bash uv run server/client.py uv run mcp dev server/multialert.py

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。